認証 v4 IdP リストの検索

ゲームサーバーは、プレイヤーIDとゲームクライアントからの成功したログイン後に返されるAppIDを使用して、ゲームに接続されたIdPリストを検索できます。ゲームは、このリストをサーバーからサーバーへ検索するためにAPIを直接実装します。

Request には AppId と PlayerID が必須パラメータとして含まれ、成功した Response は PlayerID に接続された IdP の数に応じて Data の下にある一群の変数を通じて IdP 情報を出力します。

  • リクエスト URL
    共通URL https://auth.qpyou.cn/game/player/get-idp
    分散環境URL https://auth.globalwithhive.com/game/player/get-idp
    サンドボックスURL https://sandbox-auth.qpyou.cn/game/player/get-idp
    HTTPメソッド Post
    Content-Type application/json
    データ形式 JSON
Note

認証 v4 は、ネットワーク接続の失敗やその他のエラーに応じて分散環境で構成されています。ネットワーク接続がエラーの問題によりタイムアウトした場合は、分散環境の URL を呼び出してください。

  • リクエスト ヘッダー
    フィールド名 説明 タイプ 必須
    ISCRYPT データが暗号化されているかどうか (0= 暗号化されていない) 整数 Y (常に0を送信)
  • リクエスト ボディ
    フィールド名 説明 タイプ 必須
    appid ユーザーがサインインしたゲームのAppID 文字列 はい
    player_id サインイン後の認証v4の返されたPlayerID BigInteger はい
    hive_certification_key 認証キー（AppCenterによって発行） 詳細を見る 文字列 いいえ
  • リクエスト サンプル< 
        { 
        "appid":"com.com2us.hivesdk.normal.freefull.apple.global.ios.universal",
        "player_id": 90000000062,
        "hive_certification_key" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY"
    }
  • レスポンス ボディ
    フィールド名 説明 タイプ 値
    result_code 検索結果 整数 0
    result_msg 結果メッセージ 文字列 0
    data JSON
    data.seq プレイヤーの主キー (PK) 大整数 14
    data.player_id プレイヤーID 大整数 12
    data.idp_user_id IdPによって提供されたユーザーID 文字列
    data.idp_index ユニークなIdPインデックス 文字列
    data.idp_id IdP識別子 文字列 HIVE, FACEBOOK ...
  • リクエスト サンプル< 
    { 
"appid":"com.withhive",
"did":"255764404509548", 
"player_id": 21

}
  • Response Sample< 
    {
"result_code": 0,
"result_msg": "成功",
"data":[
    {
    "seq": 10000000067,
    "player_id": 90000000062,
    "idp_user_id": "0",
    "idp_index": 0,
    "idp_id": "ゲスト"
    },
    {
    "seq": 10000000068,
    "player_id": 90000000062,
    "idp_user_id": "64646595",
    "idp_index": 1,
    "idp_id": "ハイブ"
    }
]
}
  • 結果 コード
    値 説明
    0 成功
    2002 ユーザーデータが存在しません
    4000 無効なパラメータ
    4002 認証キーエラー
  • 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