企业工商信息查询API开发指南 - 工商注册数据集成接口规范

一、接口核心能力

提供基于HTTP协议的企业基础信息查询服务，支持以下功能：

• 模糊检索：企业名称/注册号/统一信用代码智能匹配
• 关键字段返回：法定代表人、成立日期、企业类型等核心字段
• 多端适配：支持Web应用/移动端/企业系统对接

二、接口调用规范

2.1 请求协议

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

2.2 请求参数

2.3 请求示例

curl -G "https://www.xujian.tech/atlapi/data/c/query/like" \
  -d "code=ACCESS_123" \
  -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 字段说明

四、服务使用规则

• 免费额度：每日20次查询。因已被羊毛党薅哭，有需要的兄弟添加微信xujian_cq，我给你开
• 计费标准：成功查询0.01元/次（失败不计费）
• 数据更新：每日凌晨定时同步工商数据

五、典型应用场景

1. 资质核验系统：自动验证企业注册信息
2. CRM系统集成：客户信息自动补全
3. 财务管理系统：快速获取企业信用代码
4. 招投标平台：投标方资质真实性核验

六、开发对接示例

6.1 Python调用

import requests

def query_enterprise(keyword: str) -> dict:
    API_ENDPOINT = "https://www.xujian.tech/atlapi/data/c/query/like"
    params = {
        "code": "ACCESS_123",
        "keyword": keyword
    }
    return requests.get(API_ENDPOINT, params=params).json()

6.2 Java调用

import java.net.URI;
import java.net.http.*;

public class EnterpriseQuery {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        String url = "https://www.xujian.tech/atlapi/data/c/query/like"
                   ▪ "?code=ACCESS_123&keyword=重庆科技";

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

七、重要注意事项

1. 凭证安全：code参数需加密存储，禁止泄露
2. 查询优化：建议使用企业全称获取精准匹配结果
3. 数据声明：数据来源安全、稳定；接口长期稳定

本接口仅返回企业公开的工商注册信息，不包含敏感字段