本文介绍调用风险识别API时使用的公共请求参数和公共返回参数。
公共请求参数
风险识别API接口的入参参数包含公共请求参数和具体服务事件参数,公共请求参数是指每一个接口都需要使用到的参数,以下表格是公共请求参数的详细介绍。
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
String | 是 | 返回消息的格式。取值:
| |
String | 是 | API版本号,使用YYYY-MM-DD日期格式,本版本对应为2019-05-21。 | |
String | 是 | 阿里云颁发给用户的访问服务所用的密钥ID。 | |
String | 是 | 签名结果串,关于签名的计算方法,请参见签名机制调用方式第2.0节。 | |
String | 是 | 签名方式,目前支持HMAC-SHA1。 | |
String | 是 | 请求的时间戳。日期格式按照ISO8601标准表示,并需要使用UTC时间。格式为:yyyy-MM-ddTHH:mm:ssZ。例如,北京时间2019年8月22日09点44分35秒表示为2019-08-22T01:44:35Z。 | |
String | 是 | 签名算法版本,取值为1.0。 | |
String | 是 | 唯一随机数,用于防止网络重放攻击。不同请求要使用不同的随机数值。 | |
String | 是 | 值必须是ExecuteRequestSG(新加坡)或ExecuteRequestML(马来西亚)。 | |
String | 是 |
| |
String | 是 | 服务参数列表的Json格式为 |
以下是设备风险识别-增强版服务的请求参数示例:
https://saf.{region}.aliyuncs.com/
?Format=JSON
&Version=2020-07-06
&Signature=vpEEL0zFHfxXYzSFV0n7%2FZiFL9o%3D
&SignatureMethod=Hmac-SHA1
&SignatureNonce=15215528852396
&SignatureVersion=1.0
&Action=ExecuteRequest
&AccessKeyId=123****saf
&Timestamp=2018-06-01T12:00:00Z
&Service=device_risk_pro
&ServiceParameters={"deviceToken":1012****}
公共返回参数
您发送的每次接口调用请求,无论成功与否,系统都会返回唯一识别码RequestId。其他返回参数根据服务不同有不同的业务含义。
以下是设备风险识别-增强版服务返回参数的JSON
示例:
{
"RequestId": "52E3208D-E7BF-32F0-9913-2A168894D2D9",
"Message": "OK",
"Data": {
"extend": "0f533f6056f50664b48f2b3866220f0f", //Unique device ID
"tags": "is_rooted" //Reason code
},
"Code": 200 //Request succeed
}
本文中的返回示例为了便于阅读,做了格式化处理,实际返回结果没有进行换行、缩进等格式化处理。
错误码
Code | 含义描述 |
---|---|
200 | 请求成功。 |
400 | ServiceParameters(事件参数)不合法。 |
402 | QPS超过已购规格,限流。 |
403 | 权限不足,服务未开通或已到期。 |
404 | Service(服务参数)不合法。 |
500 | 内部服务器错误。 |