接口说明

最近更新时间:2019-07-20 19:03:41

接口描述

协议:HTTPS
域名:csec.api.qcloud.com
接口名:AntiFraud

请求参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,详情请参见 公共请求参数 页面。其中,此接口的 Action 字段为 AntiFraud。

注意:

此接口入参并未全部列出,请您联系天御小管家进行了解和确认;以下每个参数对于识别风险用户都非常重要,缺少则可能影响识别效果。

参数名称 类型 描述
scene Uint 业务场景 ID
0:借贷(默认值)
1:支付
name String 姓名(注意:使用中文参与鉴权签名)
emailAddress String 用户邮箱地址
address String 用户住址
mac String MAC 地址
imsi String 国际移动用户识别码
wifiMac String wifimac
wifiSSID String Wi-Fi 服务集标识
wifiBSSID String WIFI-BSSID
businessId String 业务 ID,在多个业务中使用此服务,通过此 ID 区分统计数据
phoneCryptoType Uint 手机号加密类型
0:不加密(默认值)
1:md5
2:sha256
nameCryptoType Uint 姓名加密类型
0:不加密(默认值)
1:md5

响应参数

参数说明

响应参数及其说明如下表所示:

参数名称 类型 描述
code Int 公共错误码
0:表示成功
其他值:表示失败
详见 错误码 页面中的 公共错误码 相关内容
codeDesc String 业务侧错误码
成功时返回 Success
错误时返回具体业务错误原因
message String 模块错误信息描述,与接口相关。
found Int 表示该条记录能否查到
1:能查到
-1:查不到
riskScore UInt 0 - 100:欺诈分值
值越高欺诈可能性越大
riskInfo RiskDetail 扩展字段,对风险类型的说明;
riskScore 为0 :无此字段

RiskDetail 类型说明

名称 类型 描述
riskCode UInt 风险码
riskCodeValue UInt 风险码等级

风险码

风险码及其说明请参见 风险码 页面。

请求示例

代码下载:Python 示例PHP 代码示例Java 示例.Net 示例

一个完整的请求需要两类请求参数:公共请求参数和接口请求参数。这里只列出了接口请求参数,并未列出公共请求参数,有关公共请求参数的说明可见 公共请求参数 页面。

请求示例 :
https://csec.api.qcloud.com/v2/index.php?Action=AntiFraud
&<公共请求参数>
&idNumber=1234567890
&name=%E6%9D%A8%E7%BA%A2
&phoneNumber=008613246208548

v1.0 响应示例

{"code":0,
"codeDesc":"Success",
"found":1,  //表示该条记录能被查到
"message":"No Error",
"postTime":"1436664316",
"riskInfo":
[    
{
"riskCode":6,
"riskCodeValue":3 //命中风险码6:疑似恶意欺诈,风险等级为高风险
}
], 
"riskScore":88
}

v2.0 响应示例

{"code":0,
"codeDesc":"Success",
"found":1,  //表示该条记录能被查到
"idFound":1, //表示该条记录中的 ID 能被查到
"message":"No Error",
"postTime":"1436664316",
"riskInfo":
[
{
"riskCode":1107,  //命中风险码1107:命中金融机构黑产风险名单,疑似金融欺诈行为
},     
], 
"riskScore":88
}