跳转至

查看被阻止的用户信息

游戏阻止用户检查 API 在您尝试通过社区、游戏网页等进行网页登录时,通知您 被暂停的用户

基础

  描述
请求 URL
  • 商业: https://weblogin.withhive.com/block_info
  • 沙盒: https://sandbox-weblogin.withhive.com/block_info
方法 POST
HTTP 头 内容类型: application/json
响应格式 JSON

请求

名称 类型 必需 描述
appid 字符串 应用程序ID
player_id 整数 玩家ID
language 字符串

这是语言值。如果留空,将自动设置为英语。

  • ko (韩语)
  • en (英语)
  • ja (日语)
  • zh-hans (简体中文)
  • zh-hant (繁体中文)
  • de (德语)
  • fr (法语)
  • ru (俄语)
  • es (西班牙语)
  • pt (葡萄牙语)
  • id (印尼语)
  • th (泰语)
  • vi (越南语)
  • it (意大利语)
  • tr (土耳其语)
  • ar (阿拉伯语)

响应

名称 类型 描述 备注
code 整数 结果代码
  • 100: 成功
  • 2002: 请求体不存在。
  • 2005: appid 或 player_id 不存在。
  • 2011: appid 无效。
  • 2016: 游戏无效。
  • 2019: 公司无效。

* 无效: 存在无值或空值。如果您收到 2016 或 2019,请前往 Hive 控制台 AppCenter 检查游戏或公司配置。

data 对象 结果数据
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": {}
    }