/vision/get_vision_report

1.接口描述

幻视反欺诈整合独有社交数据及多平台合作数据，全面评估用户欺诈风险

请求方式

POST

请求 URL

https://cloudapi.linkface.cn/vision/get_vision_report

2.请求参数

字段 类型 必需 描述
api_id string 是 API 账户
api_secret string 是 API 密钥
name string 是 用户姓名
phone_number string 是 用户手机号
imei_number string 否 用户设备IMEI
id_number string 是 用户身份证号
contact_list object 否 联系人列表
call_detail_list object 否 通话详单列表

参数 contact_list包含若干联系人信息，格式举例：{"18611111111": "李四", "13500000017": "赵五"}

参数call_detail_list 包含若干通话详单列表，格式举例：

[
  {
    "start_time": "2017-04-12 21:00:11", 
    "period": "1分22秒", 
    "call_type":"主叫", 
    "call_number":"18000000000",
    "self_call_location":"北京",
    "call_location":"石家庄",
    "communication_type":"国内通话",
    "fee":10.10
  },
  {
    "start_time": "2017-04-17 21:00:11", 
    "period": "1分22秒", 
    "call_type":"主叫", 
    "call_number":"18000000000",
    "self_call_location":"北京",
    "call_location":"石家庄",
    "communication_type":"国内通话",
    "fee":10.10
  }
]

3.返回参数

正常响应

字段 类型 说明
request_id string 本次请求的id
status string 状态，正常为 OK，其他值表示失败，详见错误码
result object 欺诈风险评估报告，详情见result 对象中的内容

result 对象中的内容

字段 类型 说明
overall_score number 总体信用评分，范围[0，1000]，参考值600
impact_score number 社会影响力评分，范围[0，1000]，参考值600
name_check number 验证姓名-手机号是否一致
multiloan object 多头借贷嫌疑
loansus number 小贷中介嫌疑
overdue number 该用户是否逾期
group_suspicious number 团伙骗贷嫌疑
multireg object 多头申请，指在各类p2p借贷平台有过申请

overall_score：总体信用评分，分值越高，欺诈风险越小；

impact_score：社会影响力评分，社会影响力越高，欺诈风险越小；

name_check：验证用户姓名与手机号是否一致，返回值 0：不一致；1：一致；2：未知

loansus：该用户是否有小贷中介嫌疑，取值0：否；1：是；

overdue：该用户是否逾期，取值0：未知；1：是；

group_suspicious：该用户是否有团伙骗贷嫌疑，取值0：否；1：是；2：未知

多头申请multireg 对象中的内容：

字段 类型 说明
status number 是否多头申请，返回值 0：否；1：是；2：未找到
in_1_year number 近一年申请数
in_90_days number 近90天申请数
in_30_days number 近30天申请数
total number 总申请数

参数multiloan对象中的内容：

字段 类型 说明
status number 是否有多头借贷，取值0：否；1：是；2：未找到
total number 若有嫌疑，多头借贷的数量

收费情况

status 说明 是否收费
OK 返回结果正常 是
NO_RESULT 未找到 否

返回样例

{
  "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e",
  "status": "OK",
  "result": {
    "overall_score": 675,
    "impact_score": 513,
    "name_check": 1,
    "group_suspicious": 1,
    "multiloan": {
      "status":1,
      "total":2
    },
    "loansus": 1,
    "overdue": 0,
    "multireg": {
      "status": 1,
      "in_1_year": 30,
      "in_90_days": 20,
      "in_30_days": 10,
      "total": 45
    }
  }
}

4.错误码

状态码 status 字段 说明
400 INVALID_ARGUMENT 请求参数错误，具体原因见 reason 字段内容
400 NO_RESULT 查询无结果
401 UNAUTHORIZED 账号或密钥错误
401 KEY_EXPIRED 账号过期，具体情况见 reason 字段内容
403 RATE_LIMIT_EXCEEDED 调用频率超出限额
403 NO_PERMISSION 无调用权限
403 OUT_OF_QUOTA 调用次数超出限额
500 INTERNAL_ERROR 服务器内部错误

返回样例

{
    "status": "INVALID_ARGUMENT",
    "reason": "name is required",
    "request_id": "TIDa892b593c0354b0e989b5db67a331607"
}

5.输入示例

  • CURL样例
curl -X POST -H "Content-Type: application/json" \
-d '{"api_id": xxxxx, "api_secret": "xxxxx", "name": "张三", "phone_number": "123456789", "contact_list": {"18611111111": "李四", "13500000017": "赵五"}}' \
"https://cloudapi.linkface.cn/vision/get_vision_report"

results matching ""

    No results matching ""