3. MemberKey (/player)
/player/memberKey/get
Description
Query the memberKey of the kakao 3.0 player.
memberKey can be used to determine if you are eligible for advance reservations and to pay compensation.
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 | Player ID |
Content-Type | String | Y | "application/json;charset=UTF-8" |
Authorization | String | Y | Authorization: KakaoAK {ADMIN_KEY} 예제) Authorization: KakaoAK 11118035a320f23423585acae3ded1111 |
Request Body Parameters
none
Response Content
Name | Type | Description |
|---|---|---|
memberKey | String | memberKey |
Response Status Code
Status Code | Status Code Description | Status Code Details |
|---|---|---|
200 | Normal Response | Normal |
400 | Bad Request | Request data that is not parsed. Required parameter missing or parameter type error |
401 | Unauthenticated | Authentication failed |
406 | Not Acceptable | Unable to process |
461 | Invalid Message Box | Message box with the requested messageBoxId does not exist. |
500 | Internal Server Error | Server system internal error |
503 | Service Unavailable | When service is not available (ex. timeout between internal servers) |
Example Request
POST /service/v3/player/memberKey/get HTTP/1.1
Host: openapi-zinny3.game.kakao.com:10443
Content-Type: application/json;charset=UTF-8
appId: 103815
appSecret: 951b75bf17fe0885ab5106ba2a9f9bc9
playerId: 332121989177
Authorization: KakaoAK xxxx8035a320f789f585acae3dedxxxx
{
} |
Example Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"memberKey": "tPeowElrV3iwgl7hQZtv11OXoRYLSvqu"
} |
/player/capri/memberKey/get
Description
Query the memberKey of the kakao 2.0 player.
memberKey can be used to determine if you are eligible for advance reservations and to pay compensation.
Method
POST
Request Headers
Name | Type | Mandatory | Description |
appId | String | Y | Game app ID
|
appSecret | String | Y | Authentication key issued for each game
|
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 |
|---|---|---|---|
appUserId | Long | Y | 플레이어 앱 유저 아이디 |
Response Content
Name | Type | Description |
|---|---|---|
memberKey | String | memberKey |
Response Status Code
Status Code | Status Code Description | Status Code Details |
|---|---|---|
200 | Normal Response | Normal |
400 | Bad Request | Request data that is not parsed. Required parameter missing or parameter type error |
401 | Unauthenticated | Authentication failed |
406 | Not Acceptable | Unable to process |
461 | Invalid Message Box | Message box with the requested messageBoxId does not exist. |
500 | Internal Server Error | Server system internal error |
503 | Service Unavailable | When service is not available (ex. timeout between internal servers) |
Example Request
POST /service/v3/player/capri/memberKey/get HTTP/1.1
Host: openapi-zinny3.game.kakao.com:10443
Content-Type: application/json;charset=UTF-8
appId: 103815
appSecret: 951b75bf17fe0885ab5106ba2a9f9bc9
Authorization: KakaoAK c0948035a320f789f585acae3dedcd70
{
"appUserId": 572617793
} |
Example Response
/player/legacy/memberKey/get
Description
Query the memberKey of the kakao 1.0 player.
memberKey can be used to determine if you are eligible for advance reservations and to pay compensation.
Method
POST
Request Headers
Name | Type | Mandatory | Description |
Content-Type | String | Y | "application/json;charset=UTF-8" |
Request Body Parameters
Name | Type | Mandatory | Description |
|---|---|---|---|
clientId | String | Y | Game app ID |
secretKey | String | Y | Secret key required to call Server-to-Server API |
serviceUserId | Long | Y | Service User ID |
Response Content
Name | Type | Description |
|---|---|---|
memberKey | String | memberKey |
Response Status Code
Status Code | Status Code Description | Status Code Details |
|---|---|---|
200 | Normal Response | Normal |
400 | Bad Request | Request data that is not parsed. Required parameter missing or parameter type error |
401 | Unauthenticated | Authentication failed |
406 | Not Acceptable | Unable to process |
461 | Invalid Message Box | Message box with the requested messageBoxId does not exist. |
500 | Internal Server Error | Server system internal error |
503 | Service Unavailable | When service is not available (ex. timeout between internal servers) |
Example Request
Example Response