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

Name

Type

Description

memberKey

String

memberKey

Response Status Code

Status Code

Status Code Description

Status Code Details

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

Name

Type

Mandatory

Description

appUserId

Long

Y

플레이어 앱 유저 아이디

Response Content 

Name

Type

Description

Name

Type

Description

memberKey

String

memberKey

Response Status Code 

Status Code

Status Code Description

Status Code Details

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

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

Name

Type

Description

memberKey

String

memberKey

Response Status Code 

Status Code

Status Code Description

Status Code Details

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