3. Access Token 유효성 검증 (/zat)
/zat/validate
Description
Zinny Access Token(이하 zat)의 유효성을 검증합니다.
Method
POST
Request Headers
Name | Type | Mandatory | Description |
appId | String | Y | 앱 아이디 |
appSecret | String | Y | 앱 시크릿 |
playerId | String | Y | 플레이어 아이디 |
Content-Type | String | Y | "application/json;charset=UTF-8" |
Authorization | String | Y | Authorization: KakaoAK {ADMIN_KEY} 예제) Authorization: KakaoAK 11118035a320f23423585acae3ded1111 |
Request Body Parameters
Name | Type | Mandatory | Description |
zat | String | Y | zinny access token |
Response Status Code
Status Code | Status Code 설명 | Status Code 상세 설명 |
---|---|---|
200 | 정상 응답 | 정상 |
400 | Bad Request | 파싱되지 않는 요청 데이터. 필수 파라미터 부족 or 파라미터 타입 오류 |
401 | Unauthenticated | 인증 실패 |
406 | Not Acceptable | 처리 불가 |
461 | Invalid Message Box | messageBoxId로 요청된 메시지 박스가 존재하지 않음. |
500 | Internal Server Error | 서버 시스템 내부 오류 |
503 | Service Unavailable | 서비스가 가능하지 않은 상태 (예, 내부 서버간 timeout) |
Response Content
Name | Type | Description |
---|---|---|
lang | String | 사용자의 언어 코드 |
country | String | 사용자의 국가 코드 |
market | String | 사용자의 마켓 코드 |
Example Request
POST /service/v3/zat/validate HTTP/1.1
Host: openapi-zinny3.game.kakao.com:10443
Content-Type: application/json;charset=UTF-8
appId: 103815
appSecret: 951b75bf17fe0885ab5106ba2a9f9bc9
playerId: 123412341234
Authorization: KakaoAK 11118035a320f23423585acae3ded1111
{
"zat": "CTUMCKKSdzX_t7-h83LK4XUuctmutgvoHaNGyqwQQjQAAAFOJAGGzw"
} |
Example Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"lang": "ko",
"market": "googlePlay",
"country": "kr"
} |