设备风险查询api -奇异果体育app竞彩官网下载
更新时间:2021-11-16
概述
设备风险查询api是基于百度昊天镜-设备指纹服务,提供查询设备指纹id,以及设备设备风险标签。
如果您是初次调用百度智能云产品的api,可以观看api入门视频指南,快速掌握调用api的方法。
接口规范
url
项目 | 解释 |
---|---|
地址 | |
说明 | 根据输入参数给出设备指纹id和设备风险标签。 |
请求方式 | https post |
认证机制
所有api的安全认证一律采用与请求签名机制。 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 | 通过百度昊天镜风控指纹sdk获取的zid。 | string | 必选 |
app | 设备系统类型:android、ios | string | 必选 |
接入参数举例
{
"z":"at8termq1qvdeokgqxb1lpigdddihv258fkgkh9u3lifhwqhyc_1nsxryv6avhaujvaawmys4agxcng1t8jvmua",
"app":"android"
}
响应结果
正常返回结果(正常返回结果是一个json)
字段名 | 类型 | 描述 |
---|---|---|
request_id | string | 服务端请求id |
ret_code | string | 0 |
ret_msg | string | 操作成功 |
ret_data | map | 风险详情 |
x | string | 百度昊天镜设备指纹id |
t | array | 设备风险标签。若无风险则返回为空。详细标签枚举,请您联系商务对接人员获取。 |
正常返回示例:
{
"request_id":"14875f59-0417-41cb-a31d-0d814db9b4ec",
"ret_code":"0",
"ret_msg":"操作成功",
"ret_data":{
"x":"hocn12b7mlw6kptg77hqx8qfeldorpkhlald8bc210k="
"t":["jailbreak","inject","repkg"]
}
}
异常返回结果
字段名 | 类型 | 描述 |
---|---|---|
request_id | string | 服务端请求id |
ret_code | string | 错误码: 1000-签名验证错误 1001-认证失败 1002-请求格式错误 2000-参数不合法 2001-消息体不正确 2002-服务超过最大qps/服务超过最大调用次数/服务已过期 3000-系统内部错误 其他错误码请参见: |
ret_msg | string | 出错信息 |
异常返回示例:
{
"request_id":"4017678614",
"ret_code":"1001",
"ret_msg":"认证失败"
}