認証 v4 トークンの検証

トークンの検証¶

ゲームクライアントへのログインが成功した後、ゲームサーバーはトークン、PlayerID、およびDIDを使用して、ログインユーザーのトークンキーの有効性を確認できます。したがって、ゲームが重複ログインを許可しない場合は、すでに検証されたトークンキーを管理するか、ゲーム側からセッションキーを管理してログイン機能を実装するようにしてください。

リクエスト URL

共通URL	https://auth.qpyou.cn/game/token/get-token
分散環境URL	https://auth.globalwithhive.com/game/token/get-token
サンドボックスURL	https://sandbox-auth.qpyou.cn/game/token/get-token
HTTPメソッド	Post
Content-Type	text/html
データ形式	JSON

Note

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

リクエストヘッダー

フィールド名 説明 タイプ 必須

Authorization サインイン後に返されるトークンキー文字列はい

ISCRYPT 暗号化データ、0=未暗号化整数はい

リクエストボディ

フィールド名	説明	タイプ	必須
appid	ユーザーがサインインしたゲームのAppID	文字列	はい
did	サインイン後に返されるDID	文字列	はい
player_id	サインイン後の認証v4の返されるPlayerID	整数	はい
hive_certification_key	認証キー（AppCenterによって発行）詳細を見る	文字列	いいえ

レスポンス

フィールド名 説明 タイプ

result_code 検証結果。0=成功もっと見る… 整数

result_msg 結果メッセージ文字列

リクエストサンプル<

{ 
"appid":"com.withhive",
"did":"255764404509548", 
"player_id": 21,
"hive_certification_key" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY"
}

Response Sample<

{ 
"result_code":0,
"result_message":"SUCCESS"
}

エラーコード

値	説明
0	成功
2300	返金されたアイテムの返済が必要
4000	無効なパラメータ
4001	リクエストJSONエラー
4002	認証キーエラー
5000	DBエラー
5001	分散環境（AWS）での無効なトークン
6000	無効なAppID
6001	IdPトークンエラー
7000	無効なトークン
7001	ヘッダーフィールドにトークンがありません
9999	不明なエラー

トークンを検証し、PlayerIDに対するIdP IDリストを返します¶

ゲーム内コミュニティへのログインが成功した後、トークン、PlayerID、AppID、およびDID（Authorizationトークン、PlayerID、およびDIDはログイン後にPlayerInfoに返されます）を使用して、ログインユーザーのトークンの有効性を検証し、PlayerIDに対応するIdP IDのリストを取得します。

リクエスト URL

商用サーバーURL	https://auth.qpyou.cn/server/player/get-idpuserid
分散環境URL	https://auth.globalwithhive.com/server/player/get-idpuserid
サンドボックスURL	https://sandbox-auth.qpyou.cn/server/player/get-idpuserid
HTTPメソッド	Post
Content-Type	application/json
データフォーマット	JSON

リクエストヘッダー

フィールド名 説明 タイプ 必須

Authorization ログイン成功後に返されるトークン文字列はい

ISCRYPT 暗号化されたデータ、0=未暗号化整数はい

リクエストボディ

フィールド名	説明	タイプ	必須
appid	ユーザーがログインしているゲームのAppID	文字列	はい
did	ログイン成功後に返されるDID	文字列	はい
player_id	ログイン成功後に返されるPlayerID	整数	はい

リクエストボディ例<

{
    "player_id": 20000016588,
    "appid" : "com.com2us.hivesdk.normal.freefull.google.global.android.common",
    "did" : 303581410
}

レスポンスボディ

フィールド名	説明	タイプ
result_code	検証結果、 0: 成功 4000: パラメータの値が無効です。 7000: 検証に失敗しました。検証トークンの値が一致しません。	整数
result_msg	結果メッセージ	文字列
data	結果データ	JSON

レスポンスボディ - data

フィールド名	説明	タイプ
data.list	結果データリスト	配列
data.list.player_id	リクエストボディで要求された`PlayerID`	文字列
data.list.idp_user_id	IdPから渡されたアカウントトークン (uid)	文字列
data.list.idp_index	idp_index 1: HIVE 2: Facebook 3: GOOGLE 9: APPLE	文字列

レスポンスボディサンプル<

{
        "result_code": 0,
        "result_msg": "SUCCESS",
        "data": {
                "list": [
                        {
                                "player_id": "20000016588",
                                "idp_user_id": "68101398",
                                "idp_index": "1"
                        }
                ]
        }
}