/data/check_overdue

1.接口描述

该API的功能是根据身份证号,查询该用户在各数据源是否逾期和逾期信息

请求方式

POST

请求 URL

https://cloudapi.linkface.cn/data/check_overdue

2.请求参数

字段 类型 必需 描述
api_id string API 账户
api_secret string API 密钥
id_number string 身份证号

所有中文和特殊字符必需以UTF-8编码转义。

3.返回参数

正常响应

字段 类型 说明
request_id string 本次请求的id
status string 状态,正常为 OK,其他值表示失败,详见错误码
result Object 查验结果,详情见result返回参数表

result返回参数

字段 类型 说明
status int 查验结果状态,返回值为“1”或“2”,“1”为逾期用户,“2”为非逾期用户
data Object 逾期详情,只有status1时才有此字段

收费情况

result.status字段 说明 是否收费
1 逾期用户(包括历史逾期&当前未逾期)
2 该用户非逾期用户

无逾期或查无记录的返回结果

{
  "request_id": "TID2af751b4bff24be781d60af10bf84101",
  "status": "OK",
  "result": {
    "status": 2
  }
}

逾期用户的返回结果

{
  "request_id": "TID2af751b4bff24be781d60af10bf84101",
  "status": "OK",
  "result": {
    "status": 1,
    "data": {
      "maxOverdueDays": 9,
      "lastOverdueDate": "2016-12-24",
      "maxOverdueInterest": "M14",
      "isNowOverdue": true,
      "originData": "JDB"
    }
  }
}

result.data 字段详情

result.data 字段详情 类型 说明
maxOverdueDays int 最长逾期天数
lastOverdueDate date 最近逾期发生日期
maxOverdueInterest string 最大逾期金额,详情见下表
isNowOverdue boolean 现在是否处于逾期中
originData string 数据来源

result.data.maxOverdueInterest字段详情

result.data.maxOverdueInterest 说明
M01 逾期金额小于等于500元
M02 逾期金额在(500, 1000]之间
M03 逾期金额在(1000, 2000]之间
M04 逾期金额在(2000, 3000]之间
M05 逾期金额在(3000, 4000]之间
M06 逾期金额在(4000, 6000]之间
M07 逾期金额在(6000, 8000]之间
M08 逾期金额在(8000, 10000]之间
M09 逾期金额在(10000, 15000]之间
M10 逾期金额在(15000, 20000]之间
M11 逾期金额在(20000, 25000]之间
M12 逾期金额在(25000, 30000]之间
M13 逾期金额在(30000, 40000]之间
M14 逾期金额超过40000元

4.错误码

状态码 status 字段 说明
400 ENCODING_ERROR 参数非UTF-8编码
400 INVALID_ARGUMENT 请求参数错误,具体原因见 reason 字段内容
401 UNAUTHORIZED 账号或密钥错误
401 KEY_EXPIRED 账号过期,具体原因见 reason 字段内容
403 RATE_LIMIT_EXCEEDED 调用频率过高
403 NO_PERMISSION 无调用权限
403 OUT_OF_QUOTA 调用次数超出限额
404 NOT_FOUND 请求路径错误
500 DATA_SERVER_ERROR 数据服务异常
500 INTERNAL_ERROR 内部服务异常

返回样例:

{
  "status": "INVALID_ARGUMENT",
  "reason": "argument 'name': not found",
  "request_id": "TID2af751b4bff24be781d60af10bf84101"
}
{
  "status": "INVALID_ARGUMENT",
  "reason": "Invalid id_number",
  "request_id": "TIDe43421b4631844049c8780d24a86585b"
}

5.输入示例

使用样例

  • cURL 样例
curl -X POST "https://cloudapi.linkface.cn/data/check_overdue?api_id=ID&api_secret=SECRET" -F id_number=1010000000000001

results matching ""

    No results matching ""