2. Validity of the AccessToken (/zat)
/zat/validate
Description
Verifies the validity of the Zinny Access Token (zat).
Method
POST
Request Headers
Name | Type | Mandatory | Description |
appId | String | Y | Game app ID |
appSecret | String | Y | Authentication key issued for each game |
playerId | String | Y | User ID issued by the platform |
Content-Type | String | Y | "application/json;charset=UTF-8" |
Authorization | String | Y |
(Ex) Authorization: KakaoAK 11118035a320f23423585acae3ded1111
|
Request Body Parameters
Name | Type | Mandatory | Description |
zat | String | Y | zinny access token |
Response Status Code
Status Code | Description | Details |
|---|---|---|
200 | Success | Normal |
400 | Bad Request | Request data not parsed. Lack of required parameters or parameter type error |
401 | Unauthenticated | Authentication failure (e.g., invalid appSecret) |
406 | Not Acceptable | Cannot be processed |
461 | Invalid Message Box | The Message Box requested with the messageBoxId does not exist |
500 | Internal Server Error | Server system internal error |
503 | Service Unavailable | Service unavailable (e.g., timeout between internal servers) |
Response Content
Name | Type | Description |
|---|---|---|
lang | String | User language code defined in ISO_639-1 |
country | String | User country code defined in ISO_3166-1 |
market | String | User market code (googlePlay, appStore, kakaogameShop, oneStore, so on) |
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"
} |