企业三要素(企业名称、法人姓名、税号或信用代码)认证接口技术文档
功能背景
随着数字化经济的发展,企业信息的真实性和准确性在各类场景中显得尤为重要。无论是企业合作、金融风控还是监管审查,都需要快速、高效地核实企业的基本信息。为此,我们推出了企业三要素认证接口,通过对企业名称、法人姓名和税号(即统一社会信用代码)的校验,提供可靠的信息验证服务。
作者微信
如有疑问或需求,请联系作者微信:xujian_cq。
关键词
企业三要素认证,信息核验接口,信用代码校验,企业信息验证
接口概述
企业三要素认证接口提供了对企业名称、法人姓名、税号(即统一社会信用代码)进行三要素匹配校验的功能。通过此接口,用户可以快速验证企业的基本信息,确保数据的准确性和真实性。
接口地址
https://www.xujian.tech/atlapi/data/c/3e/verify
收费标准
- 每次请求收费:0.01元
请求方式
GET
请求参数
参数名 | 类型 | 必填 | 描述 |
---|---|---|---|
code | String | 是 | 从微信小程序获取的开发者专属 code,微信小程序数字续坚首页签到取得 |
name | String | 是 | 企业名称 |
operName | String | 是 | 法人姓名 |
creditNo | String | 是 | 税号(信用代码) |
请求示例
GET https://www.xujian.tech/atlapi/data/c/3e/verify?code={code}&name={企业名称}&operName={法人名称}&creditNo={税号}
返回参数
参数名 | 类型 | 描述 |
---|---|---|
code | Int | 状态码,200 表示匹配成功 |
msg | String | 返回信息,成功时为“匹配成功” |
data | Object | 匹配成功时返回的企业详细信息 |
data.id | String | 匹配记录的唯一标识 |
data.createdAt | Long | 匹配记录的创建时间(时间戳) |
data.matchType | String | 匹配类型(如统一社会信用代码) |
data.regNo | String | 注册号 |
data.startDate | String | 成立日期 |
data.name | String | 企业名称 |
data.operName | String | 法人姓名 |
data.creditNo | String | 税号(信用代码) |
data.qxbId | String | 系统生成的唯一标识 |
data.matchItems | String | 匹配的信用代码 |
data.type | String | 类型字段,0 表示企业匹配结果 |
返回示例
{
"code": 200,
"msg": "匹配成功",
"data": {
"id": "95810",
"createdAt": 1737694516000,
"matchType": "统一社会信用代码",
"regNo": "440******",
"startDate": "2018-06-08",
"name": "******有限公司",
"operName": "**",
"creditNo": "914403******",
"qxbId": "c8cfb8a7-7577-4520-ac82-8deb27a99165",
"matchItems": "914403******",
"type": "0"
}
}
状态码说明
状态码 | 描述 |
---|---|
200 | 匹配成功 |
400 | 请求参数错误 |
401 | 授权失败 |
500 | 服务器内部错误 |
使用示例
Postman 请求截图
下图展示了通过 Postman 工具测试接口的请求和响应示例:
应用场景
- 企业认证:验证企业资质是否合法。
- 业务对接:确保业务合作对象信息的真实性。
- 金融风控:用于银行和金融机构的企业信用审核。
注意事项
- 接口调用需要提供有效的
code
授权码。 - 请求参数需严格按要求填写,确保字段无误。
- 调用频率较高时,请关注账户余额,避免因余额不足导致请求失败。
联系方式
- 作者微信:xujian_cq
以上为企业三要素认证接口的技术文档。