企查通 · 开放接口文档

接口概览

签名鉴权

1. 在后台「开放接口 → Key 管理」创建一对 Access Key 与 Secret Key。
2. 准备一个 Unix 秒级时间戳 timestamp，与服务器时间偏差不得超过 300 秒。
3. 按下列格式拼接待签名串（三行，行尾不要有多余空格）：
4. {timestamp}\n{access_key}\n{code}
5. 用 Secret Key 对签名串做 HMAC-SHA256，取十六进制小写结果作为 signature。
6. 在请求头中携带 X-Access-Key / X-Timestamp / X-Signature 发起请求。

公共参数

接口列表

GET /api/index.php?action=ping

GET /api/index.php?action=company&keyword=91310000MA1FL0XXXX

GET /api/index.php?action=search&keyword=科技&limit=10

GET /api/index.php?action=detail&id=1

GET /api/index.php?action=quota

响应结构

所有接口统一返回三层结构：code 为 0 表示成功，非 0 表示失败并同步设置对应的 HTTP 状态码；data 为业务数据；meta 为本次调用的附加信息。

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": 1024,
    "name": "示例科技有限公司",
    "credit_code": "91310000MA1FL0XXXX",
    "legal_person": "张三",
    "status": "存续"
  },
  "meta": {
    "source": "local",
    "cost": 1,
    "quota_left": 998,
    "elapsed_ms": 12
  }
}

错误码

调用示例

cURL

TS=$(date +%s)\nAK="ak_你的AccessKey"\nSK="你的SecretKey"\nCODE="KXXXXX"\n\nSIGN=$(printf "%s\n%s\n%s" "$TS" "$AK" "$CODE" | openssl dgst -sha256 -hmac "$SK" | awk '{print $2}')\n\ncurl -s "https://your-domain.com/api/index.php?action=company&keyword=91310000MA1FL0XXXX" \\n  -H "X-Access-Key: $AK" \\n  -H "X-Timestamp: $TS" \\n  -H "X-Signature: $SIGN"

PHP

$ak = 'ak_你的AccessKey';\n$sk = '你的SecretKey';\n$code = 'KXXXXX';\n$ts = time();\n\n// 签名串为三行：timestamp\naccess_key\ncode\n$sign = hash_hmac('sha256', $ts . "\n" . $ak . "\n" . $code, $sk);\n\n$ch = curl_init('https://your-domain.com/api/index.php?action=company&keyword=91310000MA1FL0XXXX');\ncurl_setopt_array($ch, [\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_HTTPHEADER => [\n        'X-Access-Key: ' . $ak,\n        'X-Timestamp: ' . $ts,\n        'X-Signature: ' . $sign,\n    ],\n]);\n$resp = curl_exec($ch);\ncurl_close($ch);\n\n$data = json_decode($resp, true);\nif ($data['code'] === 0) {\n    echo $data['data']['name'];\n} else {\n    echo '调用失败: ' . $data['msg'];\n}

Python

import time, hmac, hashlib, urllib.parse, requests\n\nAK = "ak_你的AccessKey"\nSK = "你的SecretKey"\nCODE = "KXXXXX"\nTS = str(int(time.time()))\n\n# 签名串为三行：timestamp\naccess_key\ncode\nsign_str = "{}\n{}\n{}".format(TS, AK, CODE)\nsign = hmac.new(SK.encode(), sign_str.encode(), hashlib.sha256).hexdigest()\n\nurl = "https://your-domain.com/api/index.php?" + urllib.parse.urlencode({\n    "action": "company",\n    "keyword": "91310000MA1FL0XXXX",\n})\nr = requests.get(url, headers={\n    "X-Access-Key": AK,\n    "X-Timestamp": TS,\n    "X-Signature": sign,\n}, timeout=15)\n\ndata = r.json()\nprint(data["data"]["name"] if data["code"] == 0 else data["msg"])

JavaScript

const crypto = require('crypto');

const AK = 'ak_你的AccessKey';
const SK = '你的SecretKey';
const CODE = 'KXXXXX';
const TS = Math.floor(Date.now() / 1000).toString();

// 签名串为三行：timestamp\naccess_key\ncode
const signStr = `\n\n`;
const sign = crypto.createHmac('sha256', SK).update(signStr).digest('hex');

const url = 'https://your-domain.com/api/index.php?action=company&keyword=91310000MA1FL0XXXX';
const res = await fetch(url, {
  headers: {
    'X-Access-Key': AK,
    'X-Timestamp': TS,
    'X-Signature': sign,
  },
});

const data = await res.json();
console.log(data.code === 0 ? data.data.name : data.msg);

接入须知

• 请勿把 Secret Key 放在浏览器端代码或前端仓库中，签名应在你自己的服务端完成。
• 服务器时间必须与标准时间同步，偏差超过 300 秒会导致签名校验失败（宝塔可在「面板设置」中开启 NTP 同步）。
• 建议对同一个关键词做本地缓存，避免短时间内重复调用；系统侧对已查询过的企业也有回源缓存。
• 企业名称查询建议先用统一社会信用代码定位，名称存在重名与会变动的情况。
• 本服务返回的工商数据来自公开渠道与第三方数据源，仅供参考，不作为投资或法律依据。