POST/api/v1/security/access-appeals
短期appealToken及App公共头;开发固定码HTTP兼容,正式HTTPSJSON 响应接入指南 ↗

提交封禁申诉

请求参数

正文appealToken必填(≤2048),来自当前限制响应、有效24小时并绑定当前安装;content必填5–2000 UTF-16,trim后至少5;contact可选≤254。未知字段拒绝。每安装3次/小时、IP20次/小时。不得带已撤销Bearer。

同一次限制只允许成功提交一次。账号处罚按后台处罚记录跨登录、凭据和安装持久去重;网络限制按处罚与安装隔离,不连带共享IP的其他人。设备限制按对应处罚归并。后端不接受客户端自报归并键或已提交状态。

提交使用当前App主接口地址及普通请求层,useSession:false;不要求另配设备专用HTTPS地址,也不要求先完成设备检查。当前dev固定码且显式开启allow-insecure-development时,可直接通过现有HTTP入口申请;关闭任一开发条件即恢复HTTPS要求,任意prod组合都强制HTTPS。设备材料仍使用独立HTTPS协议。

八项公共请求头全部必填:X-Client-Type=app、X-Platform=android或ios、X-App-Version、X-App-Build、X-Channel、持久X-Device-Id、每次新X-Request-Id及X-Request-Timestamp;Accept-Language为当前四语。以下统一api.request示例自动注入这些头,useSession:false不带旧Bearer。JSON沿用AES/JWE,生产强制HTTPS及JWE。

请求示例

示例UUID和说明均为合成数据;统一封装提供完整请求头,禁止记录原始设备材料或凭据。

await api.request({ path: '/api/v1/security/access-appeals', method: 'POST', useSession: false, body: {"appealToken":"限制响应中的临时凭据","content":"设备已转让给本人,请协助复核。","contact":null} });

成功响应

HTTP200、Cache-Control:no-store,固定code=SUCCESS,message按当前语言,errors=[]。JWE认证解密后示例:

{
  "code": "SUCCESS",
  "message": "操作成功。",
  "data": "11111111-1111-4111-8111-111111111111",
  "errors": []
}

data为首次真实收件的UUID字符串。后台只读展示内容,是否解封由管理员通过原封禁管理人工操作;不再有申诉核查、处理说明或平台清除申请流程。成功后App提示已提交,不重复显示可提交表单。

失败响应

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支持中英日韩、未知语言英文。失败不自动重发写请求。

限制错误的data含kind、reason、expiresAt、appealToken,见封禁接入。其他普通失败data=null;不要把DEVICE_CHECK_REQUIRED当永久封禁或自动退出循环。

426 HTTPS_REQUIRED用于未满足开发HTTP兼容条件或正式环境的HTTP请求;开发例外不会忽略HTTPS证书验证,也不豁免启用JWE时的传输要求。当前开发普通JSON请求可直接提交,有效申诉才会收件;空正文400 VALIDATION_FAILED、无效或跨安装凭据400 INVALID_DEVICE_CHECK,不能显示成成功。

重复提交返回HTTP409、APPEAL_ALREADY_SUBMITTED,data=null、errors=[],message四语本地化。重复请求不再创建记录或消耗新的收件额度,原有正文保持:

{"code":"APPEAL_ALREADY_SUBMITTED","message":"你已提交过申诉,请勿重复提交。","data":null,"errors":[]}

接入说明

此入口不受业务账号/IP/设备处罚拦截,仍受网关限流及独立材料校验。手工Nginx封禁属于另一层运维规则,可能先行拒绝。旧凭据、其他安装、篡改材料400 INVALID_DEVICE_CHECK;不得靠用户自报userId绑定申诉。

手机或邮箱申请验证码时收到的ACCOUNT_BANNED也可提供本接口的appealToken。由于尚未验证账号所有权,该申诉绑定当前安装但userId为空,后台显示未关联已验证账号,可由用户主动提供联系方式。kind=ACCOUNT不能作为已验证身份的依据,也不会因此解除处罚或恢复业务权限。

所有受限403的data新增非空布尔appealSubmitted:false表示本次限制尚未收件,true表示已提交。退出重登时直接使用服务端新响应恢复,不能只靠App内存或本机缓存。提交成功或收到APPEAL_ALREADY_SUBMITTED后,当前受限页展示“已提交过申诉”并禁止重复提交;新账号或新处罚按新响应恢复,不能沿用另一个账号的本地布尔值。解封后新产生的处罚可重新提交一次。旧凭据和历史记录保留兼容,未知账号归属不伪造本人身份。

2026-11-05已配套发布,505项服务器全量回归零失败/错误/跳过,含并发只收一次、退出重登及换安装恢复、新处罚可再提交、共享网络隔离、四语/JWE、旧凭据、只读后台与V24升级V25。V25增加持久归并键与唯一索引,保留旧记录;线上原有申诉逐条核对正文、联系方式和历史不变,归并键已回填。Flutter与管理网页已配套,真机验收由客户端任务继续。