公司基本户 API

统一社会信用代码 / 企业名称 → 名称、税号、地址、电话、开户行、银行账号

鉴权

所有 /api/* 请求需带 Key，二选一：

X-API-Key: YOUR_KEY

?key=YOUR_KEY

Key 在服务器 /opt/cardreport/gsjbh_api.conf 里。

查询

GET /api/gsjbh?q=	信用代码或公司名，返回 JSON
GET /api/gsjbh?q=&fmt=text	返回纯文本抬头
POST /api/gsjbh	Body: `{"q":"..."}`，或批量 `{"items":["...","..."]}`
GET /api/cache	缓存条数
POST /api/cache/clear	清空缓存
GET /health	健康检查，免 Key

试一试

Key 只存在本机 localStorage，不会上传到别处。

示例

# 信用代码
curl "https://lunliuzhuang.pw/api/gsjbh?q=91330100716105852F" \
  -H "X-API-Key: YOUR_KEY"

# 中文名必须 URL 编码，用 -G --data-urlencode 最省事
curl -G "https://lunliuzhuang.pw/api/gsjbh" \
  -H "X-API-Key: YOUR_KEY" \
  --data-urlencode "q=华为技术有限公司"

{
  "ok": true,
  "cached": false,
  "elapsedMs": 2841,
  "data": {
    "name": "阿里巴巴（中国）网络技术有限公司",
    "taxNo": "91330100716105852F",
    "address": "浙江省杭州市滨江区网商路699号",
    "tel": "0571-85022115",
    "bank": "招商银行股份有限公司杭州钱塘支行",
    "account": "571900288010806",
    "status": "存续",
    "legalPerson": "…",
    "exactMatch": true
  }
}

错误码

400	参数为空 / 格式不对
401	API Key 缺失或无效
404	没查到该企业
429	调用过频（本机限流或上游限流）
502	上游数据源异常
503	并发已满，稍后重试

性能与限制

缓存	同一查询 15 分钟内走缓存，命中约 1ms
上游节流	数据源是游客接口，全局串行且最小间隔 2.5s；不同企业同时查会排队
并发合并	同一家企业被多人同时查，只回源一次，其余等结果
单机限流	每 IP 60 次/分钟，超出返 429
批量	一次最多 10 条，串行执行（10 条约 25~50s）

上游为第三方公开工商数据，大额转账前请再核一次账号。