GET/api/v1/admin/users/{userId}/enforcement
管理员ADMIN_ENFORCEMENT_READJSON 响应接入指南 ↗

读取账号封禁与访问目标

请求参数

路径userId为实际用户UUID。无查询和业务正文;OWNER/VIEWER可读。返回最近90天最多50个已认证访问目标及最近50条处罚,同一数据库快照;历史有限不等于所有历史导出。

独立管理员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/enforcement', method: 'GET' });

成功响应

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

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

version为非负int64,用户级封禁并发版本。observations每项:id UUID、ip精确规范IP、platform、installationId安装UUID、lastSeenAt、deviceEligible布尔、deviceStatus。状态AVAILABLE可选第三档;NOT_REGISTERED未上报、ROLLOUT_REQUIRED尚未强制、CHECK_EXPIRED检查过期、APPLE_UNAVAILABLE平台不可用。sanctions每项:id、level、reason、createdAt、expiresAt可空、ip/ipExpiresAt可空、accountActive/ipActive/deviceActive三个布尔、revokedAt/revokeReason可空、appleSync。appleSync为NOT_REQUIRED/PENDING/APPLIED/FAILED/CLEAR_PENDING/CLEARED。时间均ISO8601;deviceActive仅表示本地规则有效,跨重装Apple是否实际写入还必须看appleSync。

失败响应

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表示并发版本或状态改变。写入审计失败全部回滚,外部平台任务状态独立。

接入说明

账号status仍是ACTIVE/DISABLED/DELETED生命周期;账号列表新增banned表示当前有效运营处罚。未接入前旧记录没有历史IP和设备,不能从型号推测或伪造目标。iOS平台标记是有限共享风险位,不是可枚举物理设备ID。

2026-11-04 API及V20已部署,435项服务器全量回归零失败/错误/跳过,覆盖三档、并发审计、四语/JWE、同系统ID新安装、独立申诉、平台同步失败、连接拦截和V19升级。线上14项只读检查通过,未封禁运行用户或采集真实设备信息。Flutter/网页配套进行中,设备required=false;Apple未配置、实际App HTTPS及真机重装尚待验收,平台替身不代表Apple已接通。