征信查询

提供个人及企业征信信息查询能力，适用于风控、授信等业务场景。

所有接口均需在请求头中携带：Authorization: Basic {Base64(appId:密钥)}

---

1. 个人征信查询

根据姓名、证件类型与证件号查询个人征信概要信息（脱敏）。

请求说明

项目	说明
请求方式	POST
请求地址	/api/credit/query/person
Content-Type	application/json

请求参数

参数名	类型	必填	说明
name	string	是	姓名
idType	string	是	证件类型：ID_CARD
idNo	string	是	证件号码
queryReason	string	是	查询原因/用途，如：贷款审批、信用卡审批

请求示例

POST /api/credit/query/person HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Basic {Base64(appId:密钥)}

{
  "name": "张三",
  "idType": "ID_CARD",
  "idNo": "110101199001011234",
  "queryReason": "贷款审批"
}

响应参数

参数名	类型	说明
code	int	状态码
data.name	string	姓名（脱敏）
data.idNo	string	证件号（脱敏）
data.creditLevel	string	信用等级：NORMAL / ATTENTION / BAD
data.score	int	信用分（若有）
data.summary	string	概要说明（脱敏）
data.reportNo	string	报告编号
data.queryTime	string	查询时间
msg	string	提示信息

响应示例

{
  "code": 0,
  "data": {
    "name": "张*",
    "idNo": "110101********1234",
    "creditLevel": "NORMAL",
    "score": 720,
    "summary": "当前无逾期记录，历史履约良好。",
    "reportNo": "CRP202402090001",
    "queryTime": "2024-02-09 15:00:00"
  },
  "msg": "success"
}

---

2. 企业征信查询

根据企业名称或统一社会信用代码查询企业征信概要信息。

请求说明

项目	说明
请求方式	POST
请求地址	/api/credit/query/enterprise
Content-Type	application/json

请求参数

参数名	类型	必填	说明
keyword	string	是	企业名称或统一社会信用代码
keywordType	string	否	KEYWORD / CREDIT_CODE，默认按关键词自动识别
queryReason	string	是	查询原因/用途

请求示例

POST /api/credit/query/enterprise HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Basic {Base64(appId:密钥)}

{
  "keyword": "91110000XXXXXXXX",
  "keywordType": "CREDIT_CODE",
  "queryReason": "合作方尽调"
}

响应示例

{
  "code": 0,
  "data": {
    "enterpriseName": "某某科技有限公司",
    "creditCode": "91110000********",
    "creditLevel": "NORMAL",
    "legalPerson": "李*",
    "regStatus": "在业",
    "summary": "企业信用状况良好，无重大不良记录。",
    "reportNo": "CRE202402090001",
    "queryTime": "2024-02-09 15:05:00"
  },
  "msg": "success"
}

错误码（征信查询通用）

code	说明
40001	参数错误或缺少必填项
40002	无查询权限或超出查询次数限制
40401	未查询到有效征信信息
500	服务器内部错误