인증 v4 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

• 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" }

  1 2 3 4 5

  {     "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 }

  1 2 3 4 5 6

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

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

  { "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