コンテンツにスキップ

ブロックされたユーザー情報の確認

ゲームのブロックされたユーザー確認APIは、コミュニティ、ゲームのウェブページなどからウェブログインを試みる際に、停止されたユーザーについて通知します。

基礎

  説明
リクエストURL
  • 商用: https://weblogin.withhive.com/block_info
  • サンドボックス: https://sandbox-weblogin.withhive.com/block_info
メソッド POST
HTTPヘッダー Content-type: application/json
レスポンスフォーマット JSON

リクエスト

名前 タイプ 必須 説明
appid 文字列 O AppID
player_id 整数 O PlayerID
language 文字列 X

これは言語の値です。空のままにすると、自動的に英語に設定されます。

  • ko (韓国語)
  • en (英語)
  • ja (日本語)
  • zh-hans (簡体字中国語)
  • zh-hant (繁体字中国語)
  • de (ドイツ語)
  • fr (フランス語)
  • ru (ロシア語)
  • es (スペイン語)
  • pt (ポルトガル語)
  • id (インドネシア語)
  • th (タイ語)
  • vi (ベトナム語)
  • it (イタリア語)
  • tr (トルコ語)
  • ar (アラビア語)

レスポンス

名前 タイプ 説明 ノート
コード 整数 結果コード
  • 100: 成功
  • 2002: リクエストボディが存在しません。
  • 2005: appidまたはplayer_idが存在しません。
  • 2011: appidが無効です。
  • 2016: ゲームが無効です。
  • 2019: 会社が無効です。

* 無効: 値が存在しないか、null値が存在します。2016または2019が返された場合は、Hive コンソール AppCenterに移動し、ゲームまたは会社の設定を確認してください。

データ オブジェクト 結果データ
data.is_blocked ブール値 ユーザーがゲームでブロックされているかどうか。
  • true: ブロックされたユーザー
  • false: 通常のユーザー
data.status 文字列 ブロック状態
  • N: 通常
  • P: 永久にブロックされている
  • B: 特定の期間ブロックされている
data.start_date 文字列 ブロックの開始日時
data.end_data 文字列 ブロックの終了日時
data.remaining_date 文字列 ブロックが解除されるまでの残り日数 これは提供された`language`値に従って表示されます(デフォルト: 英語)
data.reason 文字列 ブロックの理由 これは提供された`language`値に従って表示されます(デフォルト: 英語)

リクエストの例

    curl -X POST https://weblogin.withhive.com/block_info
    -H 'Content-Type: application/json'
    -d '{"appid": "com.com2us.hivesdk.normal.freefull.google.global.android.common", "player_id": 20000020208, "language": "ko"}'

応答の例

成功 (通常ユーザー)

    {
            "code": 100,
            "data": {
                    "is_blocked": false,
                    "status": "N",
                    "start_date": null,
                    "end_date": null,
                    "remaining_date": null,
                    "reason": null
            }
    }

成功(特定の期間ブロックされたユーザー)

    {
            "code": 100,
            "data": {
                    "is_blocked": true,
                    "status": "B",
                    "start_date": "2023-07-12 14:42:17",
                    "end_date": "2023-10-10 14:42:17",
                    "remaining_date": "90 day(s)",
                    "reason": "Temporary Restriction (Retrieve game money)"
            }
    }

成功 (ユーザーが永久にブロックされました)

    {
            "code": 100,
            "data": {
                    "is_blocked": true,
                    "status": "P",
                    "start_date": "2023-07-12 14:42:17",
                    "end_date": "9999-12-31 00:00:00",
                    "remaining_date": "Permanent",
                    "reason": "Temporary Restriction (Retrieve game money)"
            }
    }

失敗

    {
            "code": 2002,
            "data": {}
    }