当前位置：首页 > ds >正文

企业工商信息查询API接口开发指南 - 基于模糊检索的工商数据补全方案

ds 2025/7/17 12:38:45

企业工商信息查询API接口开发指南 - 基于模糊检索的工商数据补全方案

一、接口功能概述

本接口通过HTTP协议提供企业工商数据查询服务，支持以下核心功能：

模糊检索：基于企业名称/注册号/统一社会信用代码的智能匹配
关键字段返回：法定代表人、成立日期、企业类型等字段
多场景适配：支持数据清洗、资质审核、系统对接等企业级应用

二、接口调用规范

2.1 请求方式

GET https://www.xujian.tech/atlapi/data/c/query/like

2.2 请求参数

参数名	类型	必填	说明
code	string	是	访问凭证（从管理后台获取）
keyword	string	是	查询关键词（长度≥4个字符）

2.3 认证机制

curl -G "https://www.xujian.tech/atlapi/data/c/query/like" \-d "code=YOUR_ACCESS_CODE" \-d "keyword=重庆科技"

三、响应数据结构

3.1 成功响应示例

{"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"}// 其他记录...]
}

3.2 字段说明

字段名称	类型	说明
id	int	系统自增 ID
createdAt	long	记录生成时间（时间戳）
matchType	String	匹配类型（主要反映企业名称匹配情况）
regNo	String	企业注册号
startDate	String	企业成立日期
name	String	企业名称
operName	String	法定代表人名称
creditNo	String	统一社会信用代码
qxbId	String	数据标识字段（备用）
type	String	企业类型，枚举值：0 表示企业，其它值代表不同分类
matchItems	String	查询匹配依据，未来可能扩展

四、服务计费规则

免费额度：新注册用户每日20次成功查询。目前试用已停用，但可联系微信xujian_cq申请。
标准计费：成功查询0.01元/次

五、典型应用场景

CRM系统数据补全：自动填充企业工商信息
招投标审核：验证企业存续状态
供应链管理：核验供应商资质
财务系统对接：快速获取开票所需信用代码

六、调用示例

6.1 Python调用示例

import requestsdef query_enterprise(keyword):url = "https://www.xujian.tech/atlapi/data/c/query/like"params = {"code": "YOUR_ACCESS_CODE","keyword": keyword}response = requests.get(url, params=params)return response.json()

6.2 Java调用示例

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder().uri(URI.create("https://www.xujian.tech/atlapi/data/c/query/like?code=YOUR_CODE&keyword=重庆科技")).build();
HttpResponse<String> response = client.send(request, BodyHandlers.ofString());