概述

设备风险查询API是基于百度昊天镜-设备指纹服务，提供查询设备指纹ID，以及设备设备风险标签。

如果您是初次调用百度智能云产品的API，可以观看API入门视频指南，快速掌握调用API的方法。

接口规范

URL

认证机制

所有API的安全认证一律采用Access Key与请求签名机制。 Access Key由Access Key ID和Secret Access Key组成，均为字符串。 对于每个HTTP请求，使用下面所描述的算法生成一个认证字符串，提交认证字符串放在Authorization头域里。服务端根据生成算法验证认证字符串的正确性。 认证字符串的格式为：
bce-auth-v{version}/{accessKeyId}/{timestamp}/{expirationPeriodInSeconds}/{signedHeaders}/{signature}

• version是正整数。
• timestamp是生成签名时的UTC时间。
• expirationPeriodInSeconds表示签名有效期限。
• signedHeaders是签名算法中涉及到的头域列表。头域名之间用分号（;）分隔，如host;x-bce-date。列表按照字典序排列。（本API签名仅使用host和x-bce-date两个header）
• signature是256位签名的十六进制表示，由64个小写字母组成。

当百度智能云接收到用户的请求后，系统将使用相同的SK和同样的认证机制生成认证字符串，并与用户请求中包含的认证字符串进行比对。如果认证字符串相同，系统认为用户拥有指定的操作权限，并执行相关操作；如果认证字符串不同，系统将忽略该操作并返回错误码。

鉴权认证机制的详细内容请参见鉴权认证机制。

接入参数（JSON格式）

接入参数举例

    { 
      "z":"at8TermQ1qVdEokgqxb1LpiGdDDIHv258FKGKh9U3liFHWQhyC_1NsXRYV6avhaUjvaAWmYs4agXcnG1T8jvMuA",
      "app":"android"
    }

响应结果

正常返回结果（正常返回结果是一个JSON）

正常返回示例：

 {
    "request_id":"14875f59-0417-41cb-a31d-0d814db9b4ec",
    "ret_code":"0",
    "ret_msg":"操作成功",
    "ret_data":{
        "x":"HOCN12b7Mlw6KpTg77HqX8qFeLDorPkhlalD8BC210k="
        "t":["jailbreak","inject","repkg"]
    }
}

异常返回结果

异常返回示例：

 { 
    "request_id":"4017678614",
    "ret_code":"1001",
    "ret_msg":"认证失败"
}

超时建议

超时时间建议： 当风控接口响应时间过长时，为保障业务顺利运行，业务需要默认放行该次请求，建议超时时间设为200-500ms；

超时重试频次建议： 针对重要业务场景，可增加超时重试逻辑。依旧超时情况下放行处理，优先保障业务正常运行。

SDK调用指南

• Java-SDK入门指南
• PHP-SDK入门指南
• Python-SDK入门指南