本文介绍调用风险识别API时使用的公共请求参数和公共返回参数。

公共请求参数

风险识别API接口的入参参数包含公共请求参数和具体服务事件参数，公共请求参数是指每一个接口都需要使用到的参数，以下表格是公共请求参数的详细介绍。

名称 类型 是否必须 描述
Format String 是 返回消息的格式。取值：
  • JSON （默认值）
  • XML
Version String 是 API版本号，使用YYYY-MM-DD日期格式，本版本对应为2018-09-19。
AccessKeyId String 是 阿里云颁发给用户的访问服务所用的密钥ID。
Signature String 是 签名结果串，关于签名的计算方法，请参见签名机制签名方式。
SignatureMethod String 是 签名方式，目前支持HMAC-SHA1。
Timestamp String 是 请求的时间戳。日期格式按照ISO8601标准表示，并需要使用UTC时间。格式为：yyyy-MM-ddTHH:mm:ssZ。例如，北京时间2019年8月22日09点44分35秒表示为2019-08-22T01:44:35Z。
SignatureVersion String 是 签名算法版本，取值为1.0。
SignatureNonce String 是 唯一随机数，用于防止网络重放攻击。不同请求要使用不同的随机数值。
Action String 是 值必须是ExecuteRequest。
Service String 是 阿里云云盾颁发的服务code，不可随意设置。以下是各服务对应的code列表：
  • 注册风险识别-增强版服务：account_abuse_pro
  • 注册风险识别服务：account_abuse
  • 营销风险识别-增强版服务：coupon_abuse_pro
  • 营销风险识别服务：coupon_abuse
  • 登录风险识别-增强版服务：account_takeover_pro
  • 登录风险识别服务：account_takeover
  • 设备风险识别服务：device_risk
  • 风险情报服务：risk_intelligence
  • 邮箱画像服务：email_risk
  • 地址评分服务：address_validation
  • 蚁盾.营销保护服务：yd_coupon_abuse
  • 蚁盾.注册保护服务：yd_account_abuse
  • IP风险画像服务：risk_intelligence_ip
ServiceParameters String 是 服务参数列表的Json格式为{“accountId”:101234567 …该事件下其他请求参数}。以下是具体字段和参数值格式的链接列表：
以下是注册风险识别服务的请求示例： 
    https://saf.cn-shanghai.aliyuncs.com/
    ?Format=JSON
    &Version=2018-09-19
    &Signature=vpEEL0zFHfxXYzSFV0n7%2FZiFL9o%3D 
    &SignatureMethod=Hmac-SHA1
    &SignatureNonce=15215528852396
    &SignatureVersion=1.0
    &Action=ExecuteRequest
    &AccessKeyId=1234567saf 
    &Timestamp=2018-06-01T12:00:00Z
    &Service=account_abuse_pro
    &ServiceParameters={"accountId":10123567 …该事件下其他请求参数,详见具体服务的事件参数}
上一篇：附件二：众测漏洞定级标准（先知安全情报）
下一篇：开通自动续费

相关文档