/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 对象中的内容

字段 类型 说明
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 无调用权限
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 ""