/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"