PHP 7.4 + MySQL 5.6 · 支持独立域名部署

企业工商信息
一次查询,全量呈现

覆盖企业基本信息、股东出资、主要人员、分支机构、工商变更与知识产权。 本地库优先命中,未收录自动回源第三方并写入缓存 —— 查询越久,响应越快。

系统尚未安装。点击「开始安装」进入安装向导,填写数据库与管理员信息即可完成部署。
查询响应
GET /api/index.php?action=company
    &keyword=示例科技有限公司

# 命中本地库
{
  "code": 0,
  "hit_from": "local",
  "data": {
    "name": "示例科技有限公司",
    "credit_code": "91110000MA00****XX",
    "legal_person": "张示例",
    "status": "存续"
  },
  "elapsed_ms": 12
}
已收录企业
累计查询次数
在线数据源
查询账号
8 数据维度
核心能力

把工商数据查询做成一件省心的事

不是简单地把上游接口转发一遍。本地库、回源缓存、额度计费、开放接口四层各自独立,互不耦合。

本地库优先

企业数据落 MySQL 本地库,命中即返回,平均响应 10 毫秒级,不消耗上游配额、不产生第三方费用。

未收录自动回源

本地查不到时按优先级调用已配置的第三方数据源,取回后自动归一化入库并写缓存,下次直接命中。

多维度详情

基本信息、股东及出资比例、主要人员、分支机构、工商变更记录、商标与专利,一次查询全部返回。

额度制计费

每个账号独立额度,扣减走数据库事务与行级锁,并发下不会超扣;上游彻底失败自动退回,不为失败付费。

开放接口

HMAC-SHA256 签名鉴权,支持时间戳防重放、QPS 限流、调用日志与配额统计,浏览器可直接查看排版文档。

数据源可插拔

通用 HTTP 驱动 + 阿里云市场 / 企查查风格适配器,字段映射在后台可视化配置,换供应商不用改代码。

数据来源

三级查询流水线,成本与速度自动平衡

每一次查询都会记录命中来源,后台可直接看到缓存的收益。

01

本地数据库

优先按统一社会信用代码精确匹配,其次按企业名称检索。命中即返回,不产生任何外部调用。

命中即返回
02

回源缓存

历史回源结果按查询指纹缓存(默认 24 小时,可按数据源单独设置),重复查询不再打上游。

免二次调用
03

第三方数据源

按优先级依次尝试,带每日配额与失败降级。返回结果归一化后写入本地库,形成正向积累。

沉淀入本地
为什么这样设计: 直接透传上游接口的系统,每一次查询都要付费且受上游限流; 本系统把查询结果沉淀为自有数据资产 —— 常查的企业会稳定命中本地库, 上游成本随使用时间推移而下降。
字段覆盖

八个维度,覆盖日常尽调所需

字段映射在后台可视化配置,上游返回什么、本地存什么,一目了然。

企业基本信息

  • 企业名称 / 曾用名
  • 统一社会信用代码
  • 工商注册号 / 组织机构代码
  • 法定代表人
  • 注册资本 / 实缴资本
  • 成立日期 / 核准日期
  • 经营状态 / 企业类型
  • 注册地址 / 经营范围

股东出资

  • 股东名称(企业 / 自然人)
  • 持股比例
  • 认缴出资额
  • 出资日期

主要人员

  • 姓名
  • 职务(执行董事 / 监事 / 经理等)

分支机构

  • 分支机构名称
  • 负责人
  • 统一社会信用代码
  • 经营状态

工商变更

  • 变更日期
  • 变更事项
  • 变更前内容
  • 变更后内容

行业与规模

  • 所属行业(国标分类)
  • 参保人数
  • 纳税人资质
  • 营业期限

知识产权

  • 商标信息
  • 专利信息
  • 软件著作权

查询元信息

  • 数据来源(本地 / 缓存 / 上游)
  • 上游原始返回留存
  • 更新时间与耗时
  • 查询人 / 调用 Key
开放接口

三行签名,五种动作

签名串 {timestamp}\n{access_key}\n{code},HMAC-SHA256 后放进请求头即可。浏览器访问接口地址直接看到排版文档,curl 访问自动返回 JSON。

Shell · 发起查询
# 1. 准备时间戳与密钥
TS=$(date +%s)
AK=ak_你的AccessKey
SK=sk_你的SecretKey
CODE=你的Key短码

# 2. 计算签名
SIG=$(printf '%s\n%s\n%s' "$TS" "$AK" "$CODE" \
      | openssl dgst -sha256 -hmac "$SK" -hex | awk '{print $2}')

# 3. 发起请求
curl -s "https://你的域名/api/index.php?action=company&keyword=示例科技有限公司" \
  -H "X-Access-Key: $AK" \
  -H "X-Timestamp: $TS" \
  -H "X-Signature: $SIG"
ping
健康检查免签名,探测服务可用性
company
精确查询名称 / 信用代码 / 注册号,按次扣额度
search
模糊搜索关键词批量匹配,不扣额度
detail
详情查询按企业 ID 取含关联数据的完整档案
quota
额度查询读取当前 Key 的剩余额度
查看完整接口文档 →
接入流程

从下载到可用,四步

全程图形化,无需命令行、无需修改配置文件。

  1. 1

    上传部署包

    把部署包解压到站点根目录,在宝塔面板绑定域名。要求 PHP 7.4、MySQL 5.6 及以上,开启 pdo_mysqlcurl 扩展。

  2. 2

    访问 install.php

    填写数据库连接、管理员账号与站点参数,点击安装。系统自动建库建表、创建管理员、写入默认配置与示例数据。

  3. 3

    导入或配置数据源

    在后台「数据导入」上传 CSV(Excel 另存为 CSV UTF-8)/ TXT / SQL 建立自有企业库;或到「数据源」填入第三方接口的 AppKey,开启自动回源。

  4. 4

    建账号、发额度、发 Key

    新增查询账号并分配额度;需要系统对接时到「Key 管理」创建一对 AK/SK,接入方按文档签名即可调用。

常见问题

你可能想先知道这些

本地没有工商数据,能直接用吗?
可以。两种方式任选:① 在后台「数据导入」上传 CSV(Excel 另存为 CSV UTF-8 即可,表头支持中英文别名自动识别)建立自有企业库; ② 在「数据源」配置第三方接口(企查查 / 天眼查 / 阿里云市场等)的 AppKey, 查询时未收录的企业会自动回源取回并写入本地库。安装时会一并导入若干示例企业,便于先跑通流程。
对服务器环境有什么要求?
PHP 7.4(本系统按 7.4 编写)、MySQL 5.6 及以上,需开启 pdo_mysqlcurlmbstring 扩展。 纯 PHP 实现,无需 Redis、无需 Composer、无需 Node 运行时,宝塔面板新建站点后上传即可运行。
额度是怎么扣的?会重复扣费吗?
按「企业精确查询」次数扣减,模糊搜索与详情查询不扣。扣减在数据库事务内完成并加行级锁, 并发请求不会超扣。如果本地库已收录该企业,查询同样走精确查询流程、按次扣减 —— 但此时零上游成本,因为命中的是自有数据。
上游调用失败会扣额度吗?
不会。系统在扣减额度后调用上游,若上游返回失败或数据无法解析,会自动退回本次额度并写入一条退款流水, 在后台「查询日志」中可以完整追溯。
接口文档在浏览器里能直接看吗?
能。同一个入口按 Accept 头分流:浏览器访问 /api/index.php 得到排版好的文档页, curl 或 SDK 访问则返回 JSON。需要强制时加 ?format=html?format=json
数据准确性如何保证?
系统本身不生产数据,展示内容来自公开渠道与第三方数据服务商,并保留上游原始返回以便核对。 数据准确性与时效性请以国家企业信用信息公示系统等官方渠道为准,本系统结果仅供参考。
换域名或迁移服务器要注意什么?
把整站文件与数据库一起迁移即可,连接信息记录在 core/.db.json 中。 迁移后如数据库账号变化,直接访问 install.php?force=1 重新填写连接信息,原有数据不受影响。