GET/api/v1/admin/access-appeals
管理员ADMIN_ENFORCEMENT_READJSON 响应接入指南 ↗

查看封禁申诉

请求参数

OWNER/VIEWER可读。page默认1(1–100000),pageSize默认20(1–100),按createdAt及UUID倒序,列表与总数同快照。返回全部收件记录;旧state参数兼容空串、RECEIVED、REVIEWED但不再筛选,不提供核查流程。

独立管理员Cookie、可信HTTPS及真实JWE;八项公共头必填,固定admin/web/admin_web。统一封装注入当前语言、版本构建、安装UUID、请求UUID/时间戳与Cookie;后台安全保持。

请求示例

await request({path:'/api/v1/admin/access-appeals',method:'GET',query:{page:1,pageSize:20}});

统一封装自动注入八项公共头及管理员安全信息,示例不包含真实资料或凭据。

成功响应

HTTP200、Cache-Control:no-store,JSON按JWE认证解密。固定code不翻译,message按当前语言。

{"code":"SUCCESS","message":"操作成功。","data":{"items":[],"total":0,"page":1,"pageSize":20},"errors":[]}

items每项包含id(UUID)、userId(可空)、kind(ACCOUNT/IP/DEVICE/DEVICE_REVIEW)、content(申诉正文)、contact(可空)、createdAt(提交时间)。同次限制仅一份新申诉;历史重复记录保留。未验证身份的申诉userId为空,不根据kind或自报账号认定本人。

为旧客户端兼容,state、reviewedAt、reviewNote、appleClearState仍返回历史值;新后台不展示状态筛选或核查操作,也不使用这些字段驱动任何流程。不返回内部归并键、申诉Token或设备材料。

失败响应

400 BAD_REQUEST/VALIDATION_FAILED/INVALID_CLIENT_HEADERS;401 UNAUTHORIZED;403 FORBIDDEN;426 HTTPS_REQUIRED;429 AUTH_RATE_LIMITED;503 SERVICE_UNAVAILABLE,以及原JWE校验错误。普通错误data=null、errors按公共协议;提示支持中英日韩及英文回退。只读页面失败可由用户刷新,不伪造空结果。

接入说明

入口位于「封禁管理 → 封禁申诉」,只读查看内容。是否解封由管理员通过原解除封禁独立操作;申诉收件不自动解封。旧核查入口停用并固定拒绝,不再有提交核查或清除平台标记的操作。服务端去重和App已提交提示见封禁接入。