게임 실행 주소

일회성 게임 URL 생성 (토큰 포함)

post

사용자의 게임 접근을 위한 일회성 URL을 토큰과 함께 생성합니다. 생성된 URL은 제한된 시간 동안만 유효합니다.

에이전트는 API가 반환한 game_url을 회원에게 제공해야 하며, 이 URL은 iframe 또는 새 창을 통해 노출할 수 있습니다.

사용자가 존재하지 않을 경우, URL 생성과 동시에 신규 사용자가 자동으로 생성됩니다.Notice:회원에게 게임이 노출된 이후 해당 URL은 만료됩니다. 또한 새로운 게임 URL이 발급되면 이전에 생성된 URL은 자동으로 만료됩니다.

---

주요 기능:

• 사용자별 고유한 게임 접근 토큰 생성

• 일회성 URL로 보안성 강화

• 토큰 만료 시간 제한으로 무단 접근 방지

• 사용자 닉네임 설정 지원

보안 특징:

• 토큰은 한 번 사용 후 무효화

• 시간 제한이 있어 장기간 노출 위험 최소화

• Agent별 격리된 사용자 관리

사용 흐름:

1. 이 API로 게임 URL 생성

2. 클라이언트에 URL 전달

3. 사용자가 URL 접근 시 자동으로 게임 진입

4. 토큰은 사용 후 자동 무효화

Authorizations

ApiKeyAuthAgentIdAuth

api-keystringRequired

에이전트별 발급된 API 키를 입력하세요

Body

application/json

usernamestring · min: 3 · max: 50Required

사용자명, 3-30자 영문 숫자만 허용

Example: player123

nicknamestring · min: 2 · max: 50Optional

사용자 닉네임

Example: Lucky Player

gameIdnumber · min: 1Required

게임 ID

Example: 123

Responses

200

게임 URL 생성 성공

application/json

201Success

application/json

400

잘못된 요청 데이터 (유효성 검사 실패)

application/json

401

인증 실패 (API Key 또는 Agent ID 문제)

application/json

500

서버 내부 오류

application/json

post

/api/games/get-game-url

HTTPcURLJavaScriptPython

POST /api/games/get-game-url HTTP/1.1
Host: {HIGHEND-API-SERVER}
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 63

{
  "username": "player123",
  "nickname": "Lucky Player",
  "gameId": 123
}

{
  "url": "https://api.yourserver.com/api/games/enter-game?p=123&q=456&token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJnYW1lSWQiOjEyMywidXNlcklkIjo0NTYsImV4cCI6MTY0MzQ2NzIwMH0.abc123def456",
  "expiresAt": "2025-01-21T12:00:00.000Z",
  "gameInfo": {
    "id": 123,
    "title": "Fortune Tiger",
    "brand": "PG_SOFT"
  }
}