提交设备安全检查¶
请求参数¶
正文agreed必填JSON true;privacyVersion必填当前版本(≤100);Android只传androidId(16位十六进制,拒绝全0及已知异常常量),iOS只传appleDeviceToken(原生DCDevice生成的Base64,32字节以上、≤16384字符,不含空白)。另一平台字段必须不传或null;未知字段拒绝。每安装60次/小时、IP300次/小时。此写入口即使dev固定码也要求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/device-check', method: 'POST', useSession: false, body: {"agreed":true,"privacyVersion":"示例当前隐私版本","androidId":"a1b2c3d4e5f60718"} });
成功响应¶
HTTP200、Cache-Control:no-store,固定code=SUCCESS,message按当前语言,errors=[]。JWE认证解密后示例:
{
"code": "SUCCESS",
"message": "操作成功。",
"data": {
"platform": "android",
"status": "VERIFIED",
"checkedAt": "2026-11-04T10:00:00Z",
"expiresAt": "2026-11-05T10:00:00Z"
},
"errors": []
}
status=VERIFIED表示已按当前方法完成处理;Android属于系统ID的客户端上报,并非硬件证明。Android检查有效24小时,iOS15分钟,均使用ISO8601;原始系统ID、Apple令牌及内部设备摘要不返回。
失败响应¶
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当永久封禁或自动退出循环。
接入说明¶
本接口保存安装与设备关联后匹配限制。403 DEVICE_BANNED或NETWORK_BANNED、DEVICE_REVIEW_REQUIRED带独立限制data,见封禁接入。旧安装不能更换Android ID或平台;清数据后可用新安装UUID提交同一Android ID,服务端摘要仍匹配。iOS向Apple查询真实结果;平台不可用503,不返回无风险。未登录客户端须保留受限提示和申诉入口。409 CONSENT_VERSION_CHANGED要求重新读取并明确同意,不能自动勾选。
2026-11-04 API及V20已部署,435项服务器全量回归零失败/错误/跳过,覆盖三档、并发审计、四语/JWE、同系统ID新安装、独立申诉、平台同步失败、连接拦截和V19升级。线上14项只读检查通过,未封禁运行用户或采集真实设备信息。Flutter/网页配套进行中,设备required=false;Apple未配置、实际App HTTPS及真机重装尚待验收,平台替身不代表Apple已接通。