GET/api/v1/security/device-policy
匿名App公共头JSON 响应接入指南 ↗

读取设备风控接入策略

请求参数

无业务字段;不触发设备采集。返回当前平台需要的方法与启用状态。开发只读可用HTTP,生产仍要求HTTPS/JWE。

八项公共请求头全部必填: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-policy', method: 'GET', useSession: false });

成功响应

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

{
  "code": "SUCCESS",
  "message": "操作成功。",
  "data": {
    "platform": "android",
    "method": "ANDROID_ID",
    "available": true,
    "required": false,
    "appleEnvironment": null,
    "privacyVersion": "示例当前隐私版本"
  },
  "errors": []
}

platform为android/ios;method为ANDROID_ID/APPLE_DEVICECHECK;available表示服务端具备检查配置,不等于真机支持;required表示本平台登录及普通业务强制检查;appleEnvironment为development/production或空串(未配置),Android为null;privacyVersion来自当前协议同意版本。

失败响应

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当永久封禁或自动退出循环。

接入说明

先读策略及协议,在用户明确同意后才采集和提交。required=false是配套发布阶段,不表示第三档可执行;未强制的平台后台禁止新建设备处罚。iOS配置或真机能力不足不得伪造成功。

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