利用停止タイプを確認する

利用停止タイプを確認する¶

登録された利用停止タイプの一覧を照会します。運営ポリシー制限タイプ(block_type_list)と一時制限タイプ(temp_type_list)を区別して返します。未登録の言語は英語で表示されます。認証 > 利用停止 > タイプ登録を参照してください。

Basics¶

	説明
Request URL	本番: https://auth.qpyou.cn/game/block/type/get サンドボックス: https://sandbox-auth.qpyou.cn/game/block/type/get
Method	POST
HTTP Header	Content-type: application/json ISCRYPT: 0
Response Format	JSON

Request¶

Parameter	Type	Required	Description
appid	String	O	アプリID
hive_certification_key	String	O	Hive認証キー(アプリセンターで発行) 詳細
language	String	X	言語コード (デフォルト値: en) ko (韓国語) en (英語) ja (日本語) zh-hans (中国語簡体字) zh-hant (中国語繁体字) de (ドイツ語) fr (フランス語) ru (ロシア語) es (スペイン語) pt (ポルトガル語) id (インドネシア語) th (タイ語) vi (ベトナム語) it (イタリア語) tr (トルコ語) ar (アラビア語)

Response¶

Parameter	Type	Description
result_code	Integer	結果コード 0: 正常 4000: 無効なパラメータ 4002: 認証キー不一致 6000: 無効な appid
result_msg	String	結果メッセージ
data	Object	結果データ
data.block_type_list	Array	運営ポリシー制限タイプ一覧
data.block_type_list[].block_type	Integer	利用停止タイプ番号
data.block_type_list[].type_status	String	利用停止ポップアップ形式 (`O`: 運営ポリシー制限)
data.block_type_list[].type_name	String	利用停止タイプ名 (リクエストした `language` に関係なく韓国語で固定)
data.block_type_list[].type_en_name	String	利用停止タイプ名 (リクエストした `language` に関係なく英語で固定)
data.block_type_list[].reason	String	利用停止理由 (`language` 基準で返却、未登録言語は英語)
data.temp_type_list	Array	一時制限タイプ一覧
data.temp_type_list[].block_type	Integer	利用停止タイプ番号
data.temp_type_list[].type_status	String	利用停止ポップアップ形式 (`N`: 一時制限)
data.temp_type_list[].type_name	String	利用停止タイプ名 (リクエストした `language` に関係なく韓国語で固定)
data.temp_type_list[].type_en_name	String	利用停止タイプ名 (リクエストした `language` に関係なく英語で固定)
data.temp_type_list[].title	String	一時制限ポップアップタイトル (`language` 基準で返却、未登録言語は英語)
data.temp_type_list[].reason	String	一時制限ポップアップ案内メッセージ (`language` 基準で返却、未登録言語は英語)

特定言語基準でポップアップ文言をリクエストする¶

運営ツールでデフォルトの英語ではなく特定言語基準の title と reason 文言を確認する必要がある場合は、language に言語コードを入れてリクエストしてください。type_name は韓国語固定で、type_en_name は英語固定です。この API は認証が必要なため、hive_certification_key を一緒に渡してください。

curl -X POST https://auth.qpyou.cn/game/block/type/get \
-H 'Content-Type: application/json' \
-H 'ISCRYPT: 0' \
-d '{"appid": "com.com2us.hivesdk.normal.freefull.google.global.android.common", "hive_certification_key": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY", "language": "ko"}'

運営ポリシー制限と一時制限タイプを同時に受け取るレスポンスを確認する¶

リクエストが成功して result_code が 0 であれば、data.block_type_list と data.temp_type_list が一緒に返されます。サーバーで2つの配列を分けてパースし、各タイプの名前と理由を目的に合わせて使用してください。

{
  "result_code": 0,
  "result_msg": "SUCCESS",
  "data": {
    "block_type_list": [
      {
        "block_type": 1,
        "type_status": "O",
        "type_name": "불법 프로그램 이용",
        "type_en_name": "Usage of unauthorized programs",
        "reason": "불법 프로그램 이용"
      },
      {
        "block_type": 2,
        "type_status": "O",
        "type_name": "비매너 행위",
        "type_en_name": "Inappropriate Behavior",
        "reason": "비매너 행위"
      }
    ],
    "temp_type_list": [
      {
        "block_type": 25,
        "type_status": "N",
        "type_name": "임시 접속 제한(게임 데이터 수정)",
        "type_en_name": "Temporary access restriction (game data modified)",
        "title": "게임 이용에 불편을 드려 죄송합니다.",
        "reason": "현재 게임 데이터를 수정하는 중입니다. 빠른 조치를 위해 최선을 다하겠습니다."
      }
    ]
  }
}