企查查开放平台API技术接入指南

weixin_34916068

已于 2025-02-27 10:59:06 修改

阅读量688

点赞数 3

文章标签： python 开发语言

于 2025-02-27 10:57:59 首次发布

本文链接：https://blog.csdn.net/weixin_34916068/article/details/145896356

版权

一、核心接入流程

1. 账号注册与密钥获取

1. 访问[企查查开放平台官网](https://openapi.qcc.com/)完成企业实名认证
2. 在控制台「接口管理」模块选择所需服务套餐
3. 获取`AppKey`和`SecretKey`凭证对

技术准备：
新注册用户可获取测试用`Token`，有效期内支持20次免费调用，建议用于环境验证

2. 接口鉴权机制

动态签名生成原理

import hashlib
import time
def generate_token(app_key, secret_key):
    timestamp = str(int(time.time()))
    raw_str = f"{app_key}{timestamp}{secret_key}"
    return hashlib.md5(raw_str.encode()).hexdigest().upper()

请求头需包含：
- `Token`：MD5加密字符串（AppKey+Timestamp+SecretKey）
- `Timespan`：精确到秒的时间戳

3. 基础接口调用

企业模糊查询示例（Node.js）

const axios = require('axios');
const crypto = require('crypto');
async function queryEnterprise(name) {
  const timestamp = Math.floor(Date.now()/1000);
  const token = crypto.createHash('md5')
    .update(`${appKey}${timestamp}${secretKey}`)
    .digest('hex')
    .toUpperCase();

  return axios.get('https://api.qichacha.com/FuzzySearch/GetList', {
    params: { key: appKey, searchKey: name },
    headers: { Token: token, Timespan: timestamp }
  });
}

参数说明：
`searchKey`支持企业名称/注册号/统一代码等多维度检索

二、数据解析与存储

1. 响应数据结构

{
  "Result": [{
    "KeyNo": "企业唯一标识",
    "Name": "企业名称",
    "OperName": "法人代表",
    "Status": "经营状态",
    "CreditCode": "统一信用代码"
  }],
  "Status": "200",
  "Message": "Success"
}

关键字段：
- `KeyNo`用于后续详细信息查询
- `Status`包含存续/注销/吊销等状态标识

2. 异常处理机制

重试策略（Java Spring框架）

@Retryable(value = {ConnectException.class}, 
           maxAttempts = 3,
           backoff = @Backoff(delay = 2000))
public EnterpriseDetail getDetail(String keyNo) {
    // 调用企业详情接口
}

错误码体系：
- 101：鉴权失败
- 201：参数缺失
- 301：套餐额度不足