コンテンツにスキップ

ウェブログイン v1 を確認する

ウェブログイン検証 v1

このAPIは、ログイン後のログイン情報を検証します。

  • リクエスト URL
    商用サーバーURL https://weblogin.withhive.com/verify
    サンドボックスURL https://sandbox-weblogin.withhive.com/verify
  • リクエスト ヘッダー
    HTTPメソッド POST
    コンテンツタイプ application/json
  • リクエスト ボディ
    フィールド名 タイプ 説明 必須
    param string

    paramの文字列値は、以下の表のキー値で構成されたJSONデータのURLエンコーディングとBASE64エンコーディングを通じて作成されます。

    Y
  • リクエスト ボディ - param
    フィールド名 タイプ 説明
    token 文字列 web login v1が成功したときに応答値として受け取ったトークン情報。
    pid string ウェブログインv1が成功したときに受信した応答値としてのプレイヤーID情報。
  • リクエストの例
    // the original param composed of JSON object. The string value obtained by performing the URL encoding and the BASE64 encoding sequentially on this JSON object is used as the request body when calling the API.
    {
        "token": "1627881984263-jkx1B3GOY3EsJ",
        "pid": "20000009891"
    }
    // the URL encoding and BASE64 encoding result
    JTdCJTIydG9rZW4lMjIlM0ElMjIxNjI3ODgxOTg0MjYzLWpreDFCM0dPWTNFc0olMjIlMkMlMjJwaWQlMjIlM0ElMjIyMDAwMDAwOTg5MSUyMiU3RA==
    
    //Curl example. 
    // Call the API attaching the encoded param in the request body.
    curl -X POST https://weblogin.withhive.com/verify
        -H "Content-Type: application/json"
        -d "{'param': 'JTdCJTIydG9rZW4lMjIlM0ElMjIxNjI3ODgxOTg0MjYzLWpreDFCM0dPWTNFc0olMjIlMkMlMjJwaWQlMjIlM0ElMjIyMDAwMDAwOTg5MSUyMiU3RA=='}"
    
  • レスポンス ボディ

    検証が成功したかどうかを示すコードを返します。

    フィールド名 説明 タイプ 必須
    コード 検証成功の結果コード int Y
     
    コード 説明
    100 成功
    500 ログイン内部サーバーエラー(ミドルウェアサーバーの利用不可やDBサーバー接続の利用不可などの内部サーバーエラー)
    1050 リクエストボディのパラメータ値がJson形式ではありません。
    1066 リクエストボディが存在しません。
    2005 パラメータ値が存在しません。
    2200 トークンが無効です。トークンが期限切れまたはすでに検証に使用されています。
    2201 検証に失敗しました。検証トークン値が一致しません。
    2202 検証に失敗しました。検証のためのPlayerIDが一致しません。
  • Response Sample<
    {
        "code": "100";
    }