6. 카카오 ServiceUserId -> AppUserId 변환
/convert/userId
참고) 카카오 ServiceUserId 지원 종료 전까지 임시로 제공하는 API 입니다
Description
카카오 serviceUserId를 카카오 appUserId로 변환합니다.
Method
POST
Request Headers
Name | Type | Mandatory | Description |
appId | String | Y | 앱 아이디
|
appSecret | String | Y | 앱 시크릿 |
Authorization | String | Y | Authorization: KakaoAK {ADMIN_KEY} 예제) Authorization: KakaoAK 11118035a320f23423585acae3ded1111 |
Content-Type | String | Y | "application/json;charset=UTF-8" |
Request Body Parameters
Name | Type | Mandatory | Description |
|---|---|---|---|
serviceUserIdList | List<Long> | Y | serviceUserIdList |
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 |
|---|---|---|
idList | List<IdInfo> | id 목록 목록에 없다면 매핑이 존재하지 않는 아이디입니다. |
IdInfo
Name | Type | Description |
|---|---|---|
userId | String | 카카오 appUserId |
partnerUserId | String | 카카오 serviceUserId |
Example Request
POST /service/v3/convert/userId HTTP/1.1
Host: openapi-zinny3.game.kakao.com
Content-Type: application/json;charset=UTF-8
appId: 103815
appSecret: 951b75bf17fe0885ab5106ba2a9f9bc9
Authorization: KakaoAK 11118035a320f23423585acae3ded1111
{
"serviceUserIdList" : [88060333680246128,12345,123333]
} |
Example Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"idList":[
{
"userId": 2823211994,
"partnerUserId": "88060333680246128"
}
]
} |
appUserId를 playerId로 변환하는 법
https://kakaogames.atlassian.net/wiki/spaces/KS3GFC/pages/413468146/6.2.+Server+API+player#/player/getWithIdpId
위 API로 (/player/getWithIdpId)
idpCode는 “kakaocapri“
idpId는 유저의 appUserId를 채워서 호출하시면 됩니다.
/player/getListWithIdpId
위 API를 사용하신다면 idpIds 는 500개 이하로 사용해주세요
fields 값 안에 “IdpId“를 넣어서 호출하면 idpId값도 리턴되는데 그 값이 appUserId 입니다.
요청시 해더의 playerId는 필요없으니 참고 바랍니다.
탈퇴한 유저가 리턴될 수 있습니다(1주일 이내 탈퇴자)
appStatus가 normal인지 확인해주세요