소개
Sever to Server API는 플랫폼의 백앤드 서비스를 호출할 수 있는 HTTP Interface를 제공합니다.
...
또한 내부적으로 fully asynchronous 구조를 사용하여 많은 트래픽을 효과적으로 처리합니다.
타임아웃 기본 값은 5초로 설정되어있습니다.
request body 의 read timeout 은 1초입니다. header 값이 들어오고 body stream 이 1초내에 들어오지 않으면 BAD_REQUEST 처리 됩니다.
모든 API는 POST Method로 호출되어야 합니다.
현재 사용중인 버전 : v3
게임 서버에서 Sever to Server API 호출시에는 전용 포트(10443)을 사용해서 호출되어야하며
파트너 어드민에 등록된 KakaoAK {ADMIN_KEY} 를 Authorization 헤더 값으로 입력되어야합니다.
잘못된 Admin Key를 사용해서 API 호출이 1분동안 10회 이상 지속될경우 해당 remote IP에 대해서 인증 실패 처리가 됩니다.
해당 API들은 서버에서만 호출해야 하며 게임 클라이언트에서 직접 호출하지 말아야 합니다.
SDK로 제공되는 API와 기능적으로 같은 Server API는 [03. 연동가이드]의 각 항목에 설명되어 있습니다.
...
Service API
Resource URL (for Game Server)
...
Service API 는 Request의 http header에 아래의 항목이 포함 되어야 합니다.
게임서버에서 사용되는 Header
Key 는 게임센터(https://gamecenter.kakao.com)에서 확인 가능 합니다.
Key | Description | 비고 |
appId | 게임 앱 아이디 (App ID) | 모든 API 필수 |
appSecret | 게임마다 발급 받은 secret-key (Native App Key) | 모든 API 필수 |
playerId | 플레이어 ID | 플레이어에 관련된 API에서는 필수 |
Content-Type | content type | application/json 을 입력 |
Authorization | 게임 센터에 등록된 ADMIN_KEY를 사용 KakaoAK {ADMIN_KEY} | Authorization: KakaoAK {ADMIN_KEY} 예제) Authorization: KakaoAK c0948035a320f23423585acae3dedcd70 |
Request Body
Body는 JSON 형식을 갖습니다. (주의 : key=value 파라미터 방식이 아닙니다)
자세한 body 정보는 각각의 API를 참초해주십시오.
...