GAS 应用封禁用户接口

基本信息

接口描述： 在应用层面封禁用户，可设置封禁原因和时长，封禁后用户将无法使用 GAS 账号系统登录对应应用。

接口地址： https://api.chinadlrs.com/developer/ban.php

请求方式： POST

响应格式： JSON

请求参数

请求头 (Headers)

参数名	类型	必填	描述
Content-Type	string	是	必须设置为 application/json

查询参数 (Query Parameters)

参数名	类型	必填	描述	默认值
lang	string	否	响应语言（zh/en）	zh

查询参数

查询参数通过在接口地址后直接拼接的方式传递，地址和参数之间用 ? 分隔，多个参数之间用 & 连接。

例如响应语言为英文的接口地址为：
https://api.chinadlrs.com/developer/ban.php?lang=en

请求体 (Body)

参数名	类型	必填	描述	示例
appid	int	是	应用唯一标识符	1
uid	string	是	用户唯一标识符（加密）	1（未加密状态）
reason	string	否	封禁原因（加密）	"使用作弊工具"（未加密状态）
banTime	string	否	封禁时长，单位：小时（加密）	24（未加密状态）

数据加密

uid、reason 和 banTime 参数是经过加密的字符串，用于验证应用权限和保护数据安全
具体的加密算法请参考《数据加密说明文档》

封禁时长

banTime 参数表示封禁的小时数，例如：24 表示封禁 24 小时、168表示封禁 7 天（举例的 banTime 参数是未加密的状态，实际请求时需提供加密后的值）；若不提供 banTime 参数，则表示永久封禁（须在开发者运营管理平台手动移除黑名单）

请求示例

封禁用户24小时示例

{
  "appid": 1,
  "uid": "ABCD...", // 加密后的 UID
  "reason": "ABCD...", // 加密后的封禁原因
  "banTime": "ABCD..." // 加密后的封禁时长
}

永久封禁用户示例

{
  "appid": 1,
  "uid": "ABCD...", // 加密后的 UID
  "reason": "ABCD..." // 加密后的封禁原因
}

响应参数

响应参数表

参数名	类型	描述	示例
code	number	状态码	200
data	null	无数据返回	null
msg	string	响应消息	"操作成功"

成功响应示例

{
  "code": 200,
  "data": null,
  "msg": "操作成功"
}

错误响应示例

{
  "code": 400,
  "data": null,
  "msg": "参数缺失或无效"
}

状态码说明

状态码	描述	解决方案
200	封禁成功
400	参数缺失或无效	检查 uid 参数是否提供且格式正确
404	应用不存在	验证 appid 是否正确