跳转至

查看封禁类型

查看封禁类型

查询已注册的封禁类型列表。会区分并返回运营政策限制类型(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 认证密钥（在 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": "현재 게임 데이터를 수정하는 중입니다. 빠른 조치를 위해 최선을 다하겠습니다."
      }
    ]
  }
}