接口说明

最近更新时间:2019-09-20 09:33:18

接口描述

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

请求参数

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

注意:

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

参数名称 类型 描述
scene Uint 业务场景 ID
  • 0:借贷(默认值)
  • 1:支付
  • 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
  • 响应参数

    参数说明

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

    参数名称 类型 描述
    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
    }