API接口:企业名称、注册号、统一社会信用代码、企业类型、成立日期和法定代表人等数据 API 接口使用指南
本文详细介绍一种基于 Web 搜索方式实现的企业信息查询接口,适用于数据补全、企业资质验证、信息查询等场景。文章内容涵盖接口功能、请求参数、返回数据格式、计费规则以及调用示例,旨在为开发者提供技术参考。
关键词:企业信息查询, API 接口, 数据查询, Web Search API, 企业数据, 接口文档
1. 接口概述
该接口利用 HTTP GET 方法实现对企业信息的模糊检索,支持查询企业名称、注册号、统一社会信用代码、企业类型、成立日期和法定代表人等数据。返回数据采用标准 JSON 格式,便于跨平台开发和系统集成。
2. 请求方式与参数说明
2.1 请求方式
-
HTTP 方法: GET
-
接口地址:
https://www.xujian.tech/atlapi/data/c/query/like
-
有需要请联系微信:
xujian_cq
2.2 请求参数
参数 | 说明 | 备注 |
---|---|---|
code | 用户专用识别码,通过特定小程序签到获取,不可更改。 | 必填,务必保密 |
keyword | 用于模糊匹配企业名称及相关信息的关键字,长度不少于 4 个字符。 | 必填 |
3. 返回数据格式
接口返回的数据为 JSON 对象,主要包含以下字段:
字段 | 类型 | 说明 |
---|---|---|
code | Number | 状态码,200 表示查询成功 |
msg | String | 返回信息,如 "succeed." |
data | Array | 企业信息列表,每项包含详细数据 |
3.1 企业信息数据字段
每条记录包含如下信息:
字段名称 | 类型 | 说明 |
---|---|---|
id | int | 系统自增 ID |
createdAt | long | 记录生成时间(时间戳) |
matchType | String | 匹配类型(主要反映企业名称匹配情况) |
regNo | String | 企业注册号 |
startDate | String | 企业成立日期 |
name | String | 企业名称 |
operName | String | 法定代表人名称 |
creditNo | String | 统一社会信用代码 |
qxbId | String | 数据标识字段(备用) |
type | String | 企业类型,枚举值:0 表示企业,其它值代表不同分类 |
matchItems | String | 查询匹配依据,未来可能扩展 |
4. 计费规则与免费额度
- 计费方式: 成功返回查询结果后,每次调用计费 0.01 元;若查询失败不产生费用。
- 免费额度: 新用户每日可享有 20 次免费查询(仅针对成功返回数据计费)。
5. 调用示例
5.1 Curl 请求示例
以下示例展示如何使用 curl
命令调用接口,请将 YOUR_CODE_HERE
替换为实际获取的识别码:
bash
curl "https://www.xujian.tech/atlapi/data/c/query/like?keyword=重庆可乐&code=YOUR_CODE_HERE"
5.2 返回示例
接口成功查询时,将返回类似如下的 JSON 数据:
json
{
"code": 200,
"msg": "succeed.",
"data": [
{
"id": "1105",
"createdAt": 1695260987000,
"matchType": "企业名称",
"regNo": "500113014353471",
"startDate": "2021-06-02",
"name": "重庆可乐家装饰工程有限公司",
"operName": "李伦智",
"creditNo": "91500113MAABRA7D0H",
"qxbId": "58e62a6d-a6fa-482a-972d-84131629b2e4",
"matchItems": "重庆可乐家装饰工程有限公司",
"type": "0"
}
// 其他记录...
]
}
6. 使用场景及注意事项
6.1 适用场景
- 数据补全: 开票系统中自动补全企业信息。
- 企业资质验证: 用于征信系统或平台审核企业资质。
- 信息查询: 政府或企业用于统计、监督管理相关数据。
6.2 注意事项
- 参数中的
code
为固定识别码,切勿外泄。 keyword
参数建议输入不少于 4 个字符,以保证查询匹配效果。
7. 总结
本文从技术角度详细解析了企业信息查询 API 接口的使用方法和数据格式。该接口采用标准 HTTP GET 请求,返回结构化 JSON 数据,适合在数据补全、企业资质验证等场景中使用。希望本指南能为开发者在系统集成和数据服务应用中提供有价值的参考。