跳轉至

查看使用停權類型

確認停權類型

查詢已註冊的停權類型清單。回傳時會區分營運政策限制類型(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 App ID
hive_certification_key String O Hive 驗證金鑰（於 App Center 核發） 詳細內容
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。請在伺服器端分別解析這兩個陣列，並依用途使用各類型的名稱與原因。

{
  "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": "현재 게임 데이터를 수정하는 중입니다. 빠른 조치를 위해 최선을 다하겠습니다."
      }
    ]
  }
}