버전 비교

  • 이 줄이 추가되었습니다.
  • 이 줄이 삭제되었습니다.
  • 서식이 변경되었습니다.
목차
minLevel1
maxLevel1

WIP

...

/ageAuth

Description

카카오의 ci 인증정보를 가져옵니다.

...

Name

Type

Mandatory

Description

appId

String

Y

앱 아이디

appUserId

String

Y

카카오 앱 유저 아이디

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

userId

String

카카오 appUserId

partnerUserId

String

카카오 serviceUserId

Name

Type

Description

idListauthenticated_at

List<IdInfo>

id 목록

목록에 없다면 매핑이 존재하지 않는 아이디입니다.

IdInfo

String

인증받은 시각(RFC3339 internet date/time 형식)

ci_needs_agreement

boolean

사용자 동의 시 CI 정보 제공 가능

ci

String

연령인증 후 받은 CI 값

제공 조건: 사용자가 CI 동의항목에 동의한 뒤 CI 정보를 포함한 연령인증을 받은 경우

has_ci

boolean

ci 값이 있는지 여부

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]
}

...

코드 블럭
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인지 확인해주세요