封禁 (action=ban)

客户端检测到破解行为时调用，远程封禁用户/机器码/IP。通常由保护DLL在检测到异常时自动调用。

请求参数

参数名类型必填说明
actionstring是固定值 ban
tokenstring是登录令牌
ban_typestring是封禁类型：user / machine / ip / all
reasonstring可选封禁原因，默认"客户端反破解触发"
machine_codestring建议机器码（ban_type=machine或all时需要）
exec_tokenstring建议执行令牌，用于二次验证防止token被盗后恶意封禁
timestampint是时间戳

ban_type 封禁类型详解

类型说明效果
user封禁用户账号禁用用户账号，删除所有会话
machine封禁机器码将机器码加入黑名单，该设备无法使用任何账号
ip封禁IP地址将当前IP加入黑名单
all全部封禁同时封禁用户+机器码+IP（最严厉）

成功响应 (code=0)

字段名类型说明
timestampint服务器时间戳
bannedint封禁的项目数量

可能的错误码

错误码说明处理建议
9001封禁参数错误检查参数
9002token无效token或exec_token验证失败
此接口用于反破解保护，请勿滥用。恶意调用可能导致正常用户被误封。

请求示例

// 封禁用户账号
action=ban&ban_type=user&reason=检测到调试器×tamp=1700000000&token=eyJhbGciOiJIUzI1NiIs...

// 封禁机器码
action=ban&ban_type=machine&machine_code=ABC123&reason=内存修改×tamp=1700000000&token=xxx

// 全部封禁（最严厉）
action=ban&ban_type=all&exec_token=exec123&machine_code=ABC123&reason=破解行为×tamp=1700000000&token=xxx

响应示例

// 封禁用户
{
    "code": 0,
    "msg": "success",
    "timestamp": 1700000001,
    "banned": 1
}

// 全部封禁
{
    "code": 0,
    "msg": "success",
    "timestamp": 1700000001,
    "banned": 3
}

典型使用场景