淘宝开放平台

登录
文档中心 > API类目 > 反欺诈风控API

taobao.antifraud.riskassessment.get (反欺诈风险识别)

反欺诈服务是阿里大数据风控服务能力的对外输出，通过用户信誉、行为分析精准识别可信用户和风险用户并实时防御，解决交易、支付、活动等关键业务环节存在的欺诈威胁，保护企业品牌和数据，降低企业经济损失

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
collinadata_context CollinadataContext 必须 风控查询参数
  • └ app_key
  • String
  • 必须
  • 0000
  • 客户标识,由ISP指定
  • └ token_id
  • String
  • 必须
  • 00008JDiB7cor3CdaeOldunUoCc6395527768041845AD29BCDD6BBE4DE34ECB78FF0066AC359062A6D233A4C869974C8B1F5D90F09BC3A77257B841744418F883B7E61D7208D78B1874B1FD400CCD1B4208A01E428B282E511974D55E4
  • 页面生成的请求的标识.
  • └ scene_id
  • String
  • 必须
  • Register
  • 场景标识, 由ISP指
  • └ serial_no
  • String
  • 必须
  • 3E271B6F1534A95B80E08A094A948735
  • 参数签名, 签名函数由ISP提供
  • └ time_stamp
  • Number
  • 必须
  • 1439520295782
  • 发起查询的时间,用于加密serial_no
  • └ trans
  • String
  • 可选
  • {"IP":"192.168.0.1"}
  • 默认值：{}
  • 透传参数

响应参数

名称 类型 示例值 描述
risk_result ResultWrapper result
  • result
  • CollinadataQueryResult
  • 返回风控结果信息
  • └ score
  • String
  • 999
  • 积分信息.千分制
  • └ risk_level
  • String
  • pass
  • pass,review,reject
  • └ detail
  • String
  • {"a":"b"}
  • 字符串格式, 关于score生成的描述信息. 本字段可能为空.
  • └ code
  • Number
  • 0
  • 返回结果码 0为成功,其他为错误码
  • └ success
  • Boolean
  • true
  • 返回是否成功
  • └ msg
  • String
  • demo
  • 描述

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
10
11
12
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AntifraudRiskassessmentGetRequest req = new AntifraudRiskassessmentGetRequest();
CollinadataContext obj1 = new CollinadataContext();
obj1.setAppKey("0000");
obj1.setTokenId("00008JDiB7cor3CdaeOldunUoCc6395527768041845AD29BCDD6BBE4DE34ECB78FF0066AC359062A6D233A4C869974C8B1F5D90F09BC3A77257B841744418F883B7E61D7208D78B1874B1FD400CCD1B4208A01E428B282E511974D55E4");
obj1.setSceneId("Register");
obj1.setSerialNo("3E271B6F1534A95B80E08A094A948735");
obj1.setTimeStamp(1439520295782L);
obj1.setTrans("{\"IP\":\"192.168.0.1\"}");
req.setCollinadataContext(obj1);
AntifraudRiskassessmentGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
<antifraud_riskassessment_get_response>
    <risk_result>
        <result>
            <score>999</score>
            <risk_level>pass</risk_level>
            <detail>{&quot;a&quot;:&quot;b&quot;}</detail>
        </result>
        <code>0</code>
        <success>true</success>
        <msg>demo</msg>
    </risk_result>
</antifraud_riskassessment_get_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

API测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部