버전 비교

버전 이전 버전 1 새 버전 2
변경한 사람

gameplatform1

QATEAM

에 저장

키

  • 이 줄이 추가되었습니다.
  • 이 줄이 삭제되었습니다.
  • 서식이 변경되었습니다.

연동 가이드 Integration Guide > /wiki/spaces/KS4GFP/pages/547192833

목차
minLevel1
maxLevel1
outlinefalse
typelist
printablefalse

...

/auth/validation

Description

accessToken 토큰의 유효성 및 플레이어의 유효성을 검증합니다Verifies the validity of the accessToken and the player.

Method

POST

Request Headers 

Name

Type

Mandatory

Description

Content-Type

String

Y

"application/json;charset=UTF-8"

appSecret

String

Y앱

시크릿App Secret

Authorization

String

Y

Authorization: KakaoAK {ADMIN_KEY}

kgAppId

String

Y

KG 앱 아이디App ID

platform

String (Enum)

Y

접속 플랫폼 Access Platform (web, launcher, mobile, pc)

accessToken

String

Y

Access Token

playerId

String

N

플레이어 아이디. 비교 검증 용도.

런처(스퀘어) 사용 시 주의사항

...

런처(스퀘어)의 플랫폼 액세스 토큰 platform 타입은 launcher 입니다.

...

Player ID. Used for comparison validation.

Note for Launcher (Square) Users

  • The platform type for the platform access token in the launcher (Square) is "launcher".

  • When performing SDK login through the launcher (FKGTPlayer::LoginWithBridgeToken) 후 결과로 전달되는 플랫폼 액세스 토큰 platform 타입은 pc 입니다, the platform type for the access token is "pc".

Request Body

없음None

Response Status Code

Status Code

Status Code 설명Description

Status Code 상세 설명Detailed Description

200정상

응답Normal Response

정상Normal

400

Bad Request파싱되지 않는 요청 데이터. 필수 파라미터 부족 or 파라미터 타입 오류

Unparsable request data, missing mandatory parameters, or parameter type error

401

Unauthenticated인증

실패 > 게임 kick 처리Authentication failed > Game Kick

406

Not Acceptable

처리 불가 > 게임 kick 처리Cannot process > Game Kick

4xx (custom status)

플레이어 이상 상태

재로그인을 통해 이상 상태 해제 후 게임 진입 필요 > 게임 kick 처리Player Abnormal State

Re-login required to clear abnormal state > Game kick

500

Internal Server Error

서버 시스템 내부 오류Internal server error

503

Service Unavailable

서비스가 가능하지 않은 상태 (예, 내부 서버간 Service unavailable (e.g., internal server timeout)

Response Body

Name

Type

Description

player

PlayerAllResponse플레이어

정보Player information

PlayerAllResponse

Name

Type

Description

kgAppId

String

KG 앱 아이디App ID

playerId

String플레이어

아이디Player ID

status

String플레이어

상태Player status

nickname

String

닉네임Nickname

data

Map부가

데이터Additional data

Example Request

코드 블럭
languagejson
POST /service/v5/auth/validation HTTP/1.1
Host: kr-openapi-zinny3.game.kakao.com:10443
Content-Type: application/json;charset=UTF-8
appSecret: c3c38bbfa3828b342d946e9770c974d0
Authorization: KakaoAK 37faf519f278646a58a30ed73e6f8a61
kgAppId: 909428
platform: mobile
accessToken: FvNkGat8GaTfyhxHm2rNSFpn5UmvgBBU0kJYVc5kw5mP4lt4IwBFJKhINM0hSFPvnnjy0dlwoF128dDWOOLEWhTrefQ0zYDb3lzeG2uQuyOG1zKZKrwPFRpbNU6Ttno47txU3Slb8L/n6ayXqeAWAg7DtraptD3QLrylAoSNWl1SK3vsXnYy//gqI6i4gWT/ZnSswEHEvj6ooc8vR119IVs4mA==

...

코드 블럭
languagejson
HTTP/1.1 200 OK
Content-Type: application/json

{
    "player": {
        "kgAppId": "909428",
        "playerId": "123456789123456",
        "status": "normal"
    }
}

// -29401, 유효하지Invalid 않은 playerAccessToken
HTTP/1.1 401 Unauthorized
Content-Type: application/json

{
    "desc": "Token is invalid. (401.-29401)"
}  

// -10103. 플레이어Player Abnormal 이상상태State - 보호상태Protection State
HTTP/1.1 463
Content-Type: application/json;charset=UTF-8
 
{
    "desc": "playerId There is a valid lockout. (463.-10103)",
    "lockout": {
        "kgAppId": "909428",
        "idType": "playerId",
        "id": "123456789123456",
        "certMethod": "phone,card",
        "reason": "",
        "message": "",
        "notificationOption": "alimtalk",
        "memo": "",
        "lockoutCode": "",
        "lockoutSection": "mobile",
        "regTime": 1680773813000
    },
    "player": {
        "kgAppId": "909428",
        "playerId": "123456789123456",
        "status": "normal"
    },
    "token": {
        "onetimeToken": "1IB+jHhULoYJASZR18QUTQw0pDBZVjvOith9KD8miWQNsOgw4GjCGTTJhsWNUJHcWrtHJfazZ7lmLlyx"
    },
    "redirectUri": {
        "target": "lockout",
        "lockout": "https://member.kakaogames.com/lockout?token=1IB%2BjHhULoYJASZR18QUTQw0pDBZVjvOith9KD8miWQNsOgw4GjCGTTJhsWNUJHcWrtHJfazZ7lmLlyx"
    }
}

// -10102. Player 플레이어Abnormal 이상상태State - Sanction

제재Pending Unregistration
탈퇴
대기
User does 없는not 유저exist