全部产品
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件

注册防控API

更新时间:2017-06-07 13:26:11

描述

获取注册场景业务风险识别结果接口,识别:机器注册、人工恶意注册、批量短信注册等风险情况。

公共请求参数

参见:公共请求参数

业务请求参数

名称 类型 是否必须 描述
phoneNumber String 关联账号的手机号。
手机号码的格式为国家码-手机号的格式,如中国手机号86-13088889999或美国手机号001-9096185426,如果不加国家码都视为中国手机号码。
【phone_number ,email, (user_id,id_type)三种必选其一】
ip String 注册时候的IP地址
source int 注册来源。1:PC网页;2:移动网页;3:APP;4:其它
JsToken String 接入JS后获取的token;
source来源为1&2&4时,必选;
SDKToken String 接入SDK安全组件后从服务端获取的wtoken;
source来源为3时,必选;
email String 关联账号的email。【phone_number ,email, (user_id,id_type)三种必选其一】
userId String 账号的全局唯一标识,为了提高准确率,建议带上该字段。【phone_number ,email, (user_id,id_type)三种必选其一】
idType String 账号的全局唯一标识,为了提高准确率,建议带上该字段。【phone_number ,email, (user_id,id_type)三种必选其一】
register_url String 当前注册的页面URL;
Source为1,2时,该参数必选
agent String 发送HTTP请求的代理
cookie String cookie
sessionId String Session id
macAddress String 硬件信息
referer String 上一跳信息
nick_name String 账号绑定的呢称
companyName String 账号绑定的公司名字
address String 账号绑定的注册的地址
IDNumber String 账号绑定的身份证号
bankCardNumber String 账号绑定的银行卡号
extend_data String 扩展字段。json格式的字符串,根据具体情况而定
protocolVersion String 协议版号。现在的值是1.0

请求示例

  1. http://jaq.aliyuncs.com/?
  2. Action= SpamRegisterPrevention
  3. & phoneNumber=13211111111
  4. &email=123@.com
  5. &userId=xxx
  6. &idType=1
  7. &ip=127.0.0.1
  8. &source=3
  9. &currentUrl=xxx
  10. &agent=xxx
  11. &cookie=xxx
  12. &sessionId=xxx
  13. &macAddress=xxx
  14. &referer=xxx
  15. &userName=xxx
  16. &companyName=xxx
  17. &address=xxx
  18. &idNumber=xxx
  19. &bankCardNumber=xxx
  20. &jsToken=xxx
  21. &sdkToken=xxx
  22. &protocolVersion=xxx
  23. &extendData=xxx
  24. & (加上公共入参)

响应结果

名称 类型 描述
final_decision String 风险等级。0:无风险;1:高风险;2:中风险
final_score String 风险得分。0~999:分数越高,风险越低
user_id String 注册用户id
final_desc int 综合风险描述
captcha_check_data String UI验证所需的信息

成功响应结果:

  1. json
  2. {
  3. "data": {
  4. "eventId":"xxx",
  5. "finalDecision":"xxx",
  6. "finalDesc":"xxx",
  7. "finalScore":"100",
  8. "userId":"123",
  9. "detail":"xxx",
  10. "captchaCheckData":"xxx"
  11. },
  12. "ErrorMsg":"Success",
  13. "ErrorCode":0
  14. }

失败响应结果:

  1. json
  2. {
  3. "Message":"invalid parameter.",
  4. "RequestId":"A649BA1E-76CF-4CD7-82D7-BD835533C96F", "HostId":"jaq.aliyuncs.com",
  5. "Code":"400"
  6. }

特定错误码:

错误码 含义
errorCode 400 参数错误
errorCode 500 系统内部错误
本文导读目录