Searching Authentication v4 IdP lists

The game server can searh the IdP lists connected with games by using the PlayerID and AppID returned from the game client after successful login. Game implements this API directly to search the lists server to server.

Request includes AppID and PlayerID as essential parameters, and successful Response outputs IdP information through a group of variables under Data in accordance with the number of IdPs connected with PlayerID.

  • Request URL
    Common URL https://auth.qpyou.cn/game/player/get-idp
    Distributed Environment 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

Authentication is composed of a distributed environment in response to network connection failure or other errors. If network connection have a timeout due to any error issues, call the distributed environment URL.

  • Request Header
    Field Name Description Type Required
    ISCRYPT Whether data is encrypted (0= not encrypted) Integer Y (Always send 0)
  • Request Body
    Field Name Description Type Required
    appid AppID of a game which user signed in String Y
    player_id Returned PlayerID of Authentication after sign-in BigInteger Y
    hive_certification_key Hive Platform certification key (issued by App Center, see ../../../operation/appcenter/gamemanagement#list02-01) 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
    Field Name Description Type Value
    result_code Search result Integer 0
    result_msg Result message String 0
    data JSON
    data.seq Primary key (PK) for player BigInteger 14
    data.player_id PlayerID BigInteger 12
    data.idp_user_id User ID provided by IdP String
    data.idp_index Unique IdP index String
    data.idp_id IdP identifier 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
    Value Description
    0 Success
    2002 No user data exists
    4000 Invalid parameter
    4002 Hive Platform certification key error
  • idp_index
    idp_index idp_id Description
    0 GUEST Players who did not athenticate IdP
    1 HIVE Hive Platform
    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 Sign in with Apple
    10 LINE LINE
    12 WEVERSE Weverse