4. 멤버 키 조회 (/player)
/player/memberKey/get
Description
kakao 3.0 플레이어의 멤버 키를 조회합니다.
멤버 키는 사전 예약 대상자인지 확인하고 보상을 지급하는데에 사용할 수 있습니다.
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
none
Response Content
Name | Type | Description |
|---|---|---|
memberKey | String | 멤버 키 |
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) |
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
kakao 2.0 플레이어의 멤버 키를 조회합니다.
멤버 키는 사전 예약 대상자인지 확인하고 보상을 지급하는데에 사용할 수 있습니다.
Method
POST
Request Headers
Name | Type | Mandatory | Description |
appId | String | Y | 앱 아이디
|
appSecret | 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 |
|---|---|---|---|
appUserId | Long | Y | 플레이어 앱 유저 아이디 |
Response Content
Name | Type | Description |
|---|---|---|
memberKey | String | 멤버 키 |
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) |
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
kakao 1.0 플레이어의 멤버 키를 조회합니다.
멤버 키는 사전 예약 대상자인지 확인하고 보상을 지급하는데에 사용할 수 있습니다.
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 | 클라이언트 아이디 |
secretKey | String | Y | 서버 to 서버 API 호출에 필요한 시크릿 키 |
serviceUserId | Long | Y | 서비스 유저 아이디 |
Response Content
Name | Type | Description |
|---|---|---|
memberKey | String | 멤버 키 |
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) |
Example Request
Example Response