按三档封禁账号¶
请求参数¶
仅OWNER。正文expectedVersion必填非负JSON整数;level必填ACCOUNT/ACCOUNT_IP/ACCOUNT_IP_DEVICE;reason必填非空≤500 UTF-16,可向本人展示;expiresAt可空(长期)或未来至少60秒、至多3650天。第二、三档必须observationId(同账号最近90天访问UUID)及ipExpiresAt(未来至少60秒、最多7天,不能晚于有限expiresAt)。第一档不得传目标或IP期限。未知字段拒绝。
独立管理员Cookie、可信HTTPS及真实JWE;八项公共头必填,固定admin/web/admin_web。统一request封装注入当前语言、版本构建、安装UUID、请求UUID/时间戳与Cookie;写操作另带同源Origin和X-Admin-CSRF。后台安全保持。
请求示例¶
示例UUID和说明均为合成数据;统一封装提供完整请求头,禁止记录原始设备材料或凭据。
await request({ path: '/api/v1/admin/users/11111111-1111-4111-8111-111111111111/bans', method: 'POST', body: {"expectedVersion":0,"level":"ACCOUNT","reason":"经核实存在严重违规行为。","expiresAt":null} });
成功响应¶
HTTP200、Cache-Control:no-store,固定code=SUCCESS,message按当前语言,errors=[]。JWE认证解密后示例:
{
"code": "SUCCESS",
"message": "操作成功。",
"data": {
"userId": "11111111-1111-4111-8111-111111111111",
"version": 1,
"observations": [],
"sanctions": []
},
"errors": []
}
成功data结构见封禁详情,示例省略列表内容;实际返回新处罚及目标。创建、并发版本、会话撤销和USER_BAN审计同事务。一个账号已有有效处罚时409,不自动覆盖;先明确解除再新建。
失败响应¶
400 BAD_REQUEST/VALIDATION_FAILED/INVALID_CLIENT_HEADERS或本文业务错误;401 UNAUTHORIZED;403 FORBIDDEN或本文限制错误;426 HTTPS_REQUIRED;429 AUTH_RATE_LIMITED;503 SERVICE_UNAVAILABLE/DEVICE_CHECK_UNAVAILABLE。固定code不翻译,message支持中英日韩、未知语言英文。失败不自动重发写请求。
400 INVALID_ENFORCEMENT表示范围或字段不符;404 NOT_FOUND表示目标不存在;409 ENFORCEMENT_CONFLICT表示并发版本或状态改变。写入审计失败全部回滚,外部平台任务状态独立。
接入说明¶
第三档只有deviceEligible=true才可提交,否则409 DEVICE_ENFORCEMENT_UNAVAILABLE;不能降级成安装UUID后宣称封住重装。账号立即阻止后续请求,IP/设备独立命中;已有在途请求不保证被中断。旧会话撤销后解封不恢复。Apple写入排队,PENDING/FAILED不能显示已完成跨重装封禁。封禁不删除账号、清余额或发放/撤销会员。
2026-11-04 API及V20已部署,435项服务器全量回归零失败/错误/跳过,覆盖三档、并发审计、四语/JWE、同系统ID新安装、独立申诉、平台同步失败、连接拦截和V19升级。线上14项只读检查通过,未封禁运行用户或采集真实设备信息。Flutter/网页配套进行中,设备required=false;Apple未配置、实际App HTTPS及真机重装尚待验收,平台替身不代表Apple已接通。