IDP 목록 조회

게임 클라이언트에서 로그인 성공 후 반환된 PlayerID, AppID를 이용하여 게임 서버에서는 게임에 연동된 IdP 목록을 조회할 수 있습니다. 해당 API는 게임에서 서버 대 서버로 직접 호출하는 형식입니다.

Request는 AppId와 PlayerID가 필수 파라미터이며, Response는 성공 시 PlayerID에 연동된 IdP 개수에 따라 Data 구조체 내에 IdP 정보를 출력합니다.

  • Request URL
상용 URL https://auth.qpyou.cn/game/player/get-idp
분산환경 URL https://auth.globalwithhive.com/game/player/get-idp
Sandbox URL https://sandbox-auth.qpyou.cn/game/player/get-idp
HTTP Method Post
Content-Type application/json
Data Format JSON
Note

인증 v4는 장애가 발생하거나 네트워크 통신이 원활하지 않을 경우에 대비하여 분산 환경을 구성하고 있습니다. 만약 장애나 네트워크 통신 이상으로 게임서버에 정의된 통신 타임아웃 시간을 초과하면 분산환경 URL를 호출해야 합니다.

  • Request Header
필드명 설명 타입 필수여부
ISCRYPT 데이터 암호화 여부 (0= 암호화 안 함) Integer Y
(무조건 0으로 전달)
  • Request Body
필드명 설명 타입 필수여부
appid 로그인 한 게임의 AppID String Y
player_id 로그인 성공 후 반환된 V4인증 PlayerID BigInteger Y
hive_certification_key Hive 인증키(앱센터에서 발급) 자세히 String N
  • Request Sample
{ 
    "appid":"com.com2us.hivesdk.normal.freefull.apple.global.ios.universal",
    "player_id": 90000000062,
    "hive_certification_key" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY"
}
  • Response Body
필드명 설명 타입 값
result_code 결과 코드 Integer 0
result_msg 결과 메시지 String 0
data JSON
data.seq 플레이어 기본 키 (PK) BigInteger 14
data.player_id PlayerID BigInteger 12
data.idp_user_id IdP에서 주는 회원 ID 값 String
data.idp_index IdP 고유 번호 String
data.idp_id IdP의 String 값 String HIVE, FACEBOOK ...
  • Request Sample
{ 
    "appid":"com.withhive",
    "did":"255764404509548", 
    "player_id": 21

}
  • Response Sample
{
 "result_code": 0,
 "result_msg": "SUCCESS",
 "data":[
  {
   "seq": 10000000067,
   "player_id": 90000000062,
   "idp_user_id": "0",
   "idp_index": 0,
   "idp_id": "GUEST"
  },
  {
   "seq": 10000000068,
   "player_id": 90000000062,
   "idp_user_id": "64646595",
   "idp_index": 1,
   "idp_id": "HIVE"
  }
 ]
}
  • Result code
코드값 설명
0 성공
2002 유저 데이터 없음
4000 유효하지 않은 파라미터
4002 Hive 인증키 에러
  • idp_index
idp_index idp_id 설명
0 GUEST IdP 인증을 받지 않은 경우
1 HIVE HIVE
2 FACEBOOK Facebook
3 GOOGLE Google (Play Games Services)
4 QQ QQ
5 WEIBO Weibo
6 VK VK
7 WECHAT WeChat
8 APPLE Apple Game Center
9 SIGNIN_APPLE Apple Login
10 LINE Line
12 WEVERSE Weverse