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

taobao.antifraud.riskuser.get (反欺诈用户风险查询)

根据用户基础信息,核实平台上的用户是否存在欺诈风险

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_account_query ParamAccountQuery 可选 风险用户查询条件
  • └ app_key
  • String
  • 必须
  • 9900
  • 反欺诈服务AppKey
  • └ timestamp
  • String
  • 必须
  • 1234567890
  • 时间戳
  • └ app_token
  • String
  • 必须
  • 59a84f33241144f0b3fdb63edad03f92
  • 身份校验信息
  • └ scene_id
  • String
  • 必须
  • Register
  • 场景ID
  • └ phone_number
  • String
  • 必须
  • 13911111111
  • 手机号
  • └ ip
  • String
  • 必须
  • 192.168.1.1
  • IP
  • └ trans
  • String
  • 可选
  • {"email":"a@taobao.com"}
  • 透传参数,是一个json形式的字符串

响应参数

名称 类型 示例值 描述
event_id String 111-111-222-000 服务调用成功时, 返回的系统流水号
score String 50 风险分值
risk_level String pass 风险结果, 为reject, review, pass三者之一
detail_list AccountRiskDetail [] 风险结果详情列表,包含多个风险结果单项
  • └ name
  • String
  • demo
  • 表示一个具体的用户风险详情

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AntifraudRiskuserGetRequest req = new AntifraudRiskuserGetRequest();
ParamAccountQuery obj1 = new ParamAccountQuery();
obj1.setAppKey("demo");
obj1.setTimestamp("demo");
obj1.setAppToken("demo");
obj1.setSceneId("demo");
obj1.setPhoneNumber("demo");
obj1.setIp("demo");
obj1.setTrans("demo");
req.setParamAccountQuery(obj1);
AntifraudRiskuserGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<antifraud_riskuser_get_response>
    <event_id>111-111-222-000</event_id>
    <score>50</score>
    <risk_level>pass</risk_level>
    <detail_list>
        <account_risk_detail>
            <name>demo</name>
        </account_risk_detail>
    </detail_list>
</antifraud_riskuser_get_response>

异常示例

  • XML示例
  • JSON示例
<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

FAQ

返回
顶部