企业官网建设流程全解析

企业全景信息查询 API：工商照面 33 项、股东出资、变更与社保一次查全

做供应商准入、客户尽职调查、授信风控时，需要的信息往往不止「这家公司存不存在」：经营状态是否正常、注册资本与实缴、股东结构与出资明细、历史上改过什么、参保人数有没有异常——这些信息分散在工商公示的不同板块里，逐个去查要调好几个接口、拼好几套字段。

enterprise.detail把四个维度合并成一次查询：工商照面 33 项 + 股东及认缴 / 实缴出资 + 工商变更记录 + 分年度社保参保，一次 GET 请求全部返回，并且查不到该企业不收费。

接口速览

一、哪些业务需要这一步

二、请求参数

2.1 请求头

2.2 查询参数

2.3 关键词怎么填才查得准

• 优先用统一社会信用代码：18 位，唯一且不会重名，准确率最高。
• 用名称时必须是登记全称。接口不做模糊匹配，传简称大概率查不到。
• 拿不准全称时，先用企业信息模糊查询（enterprise.query，0.01 元/次）校正全称，再查本接口，比反复猜更省钱。

三、返回字段

3.1 顶层与 data

data 字段：

3.2 basicInfo：工商照面 33 项

3.3 partners[]：股东与出资

shouldCapiItems[]/realCapiItems[]元素：date（出资日期）、capi（金额，如100 万人民币）、type（出资方式，如货币）。

3.4 changeRecords[]：工商变更

3.5 socialSecurity[]：分年度社保参保

3.6 三个字段口径

1. -不等于null，也不等于 0。它是工商数据里的「未公示 / 长期 / 无值」占位符，展示时写「—」即可。
2. 缺失字符串是""，缺失数组是[]，不用null表示，解析时按空值兜底即可。
3. 上游内部id与法定代表人身份哈希operPid不对外返回，不要依赖。

四、调用示例

4.1 curl

curl-s-G"https://api.xujian.tech/openapi/enterprise/detail"\--data-urlencode"keyword=91500113MAABRA7D0H"\-H"X-API-Key: 你的APIKey"

4.2 Java（Hutool）

importcn.hutool.http.HttpRequest;importcn.hutool.json.JSONObject;importcn.hutool.json.JSONUtil;publicclassEnterpriseDetailClient{privatestaticfinalStringAPI_URL="https://api.xujian.tech/openapi/enterprise/detail";/** * 查询企业详细信息 * * @param apiKey 开发者 API Key * @param keyword 企业全称或统一社会信用代码 * @return data 节点；查不到或失败返回 null，且不扣费 */publicstaticJSONObjectdetail(StringapiKey,Stringkeyword){JSONObjectjson=JSONUtil.parseObj(HttpRequest.get(API_URL).header("X-API-Key",apiKey).form("keyword",keyword).timeout(20000).execute().body());if(json.getInt("code")==null||json.getInt("code")!=0){System.out.println("查询失败（不收费）："+json.getStr("msg"));returnnull;}returnjson.getJSONObject("data");}publicstaticvoidmain(String[]args){JSONObjectdata=detail("你的APIKey","91500113MAABRA7D0H");if(data==null){return;}JSONObjectbasic=data.getJSONObject("basicInfo");System.out.printf("%s | %s | 法人 %s | 注册资本 %s | 股东 %d 人%n",basic.getStr("name"),basic.getStr("newStatus"),basic.getStr("operName"),basic.getStr("registCapi"),data.getJSONArray("partners").size());}}

4.3 Python

importrequestsdefenterprise_detail(api_key:str,keyword:str):"""返回 data 节点；查不到或失败返回 None，且不扣费"""resp=requests.get("https://api.xujian.tech/openapi/enterprise/detail",params={"keyword":keyword},headers={"X-API-Key":api_key},timeout=20,)result=resp.json()ifresult.get("code")!=0:print("查询失败（不收费）：",result.get("msg"))returnNonereturnresult["data"]if__name__=="__main__":data=enterprise_detail("你的APIKey","91500113MAABRA7D0H")ifdata:print(data["basicInfo"]["name"],data["basicInfo"]["newStatus"])

4.4 JavaScript

asyncfunctionenterpriseDetail(apiKey,keyword){constqs=newURLSearchParams({keyword}).toString();constresp=awaitfetch(`https://api.xujian.tech/openapi/enterprise/detail?${qs}`,{headers:{"X-API-Key":apiKey}});constresult=awaitresp.json();if(result.code!==0){thrownewError(result.msg);}returnresult.data;}

五、返回示例

{"code":0,"msg":"success","data":{"keyword":"91500113MAABRA7D0H","basicInfo":{"name":"重庆可乐家装饰工程有限公司","creditNo":"91500113MAABRA7D0H","regNo":"500113014353471","status":"存续（在营、开业、在册）","newStatus":"存续","operName":"李伦智","registCapi":"100 万人民币","actualCapi":"-","startDate":"2021-06-02","termEnd":"-","econKind":"有限责任公司","domain":"D4511","address":"重庆市巴南区龙洲湾街道龙洲大道255号17-1","belongOrg":"重庆市巴南区市场监督管理局","districtCode":"500110","scope":"许可项目：住宅室内装饰装修（依法须经批准的项目，经相关部门批准后方可开展经营活动）","tags":[],"historyNames":[]},"partners":[{"name":"李伦智","stockType":"自然人股东","stockPercent":"1.0","totalShouldCapi":"100 万人民币","shouldCapiItems":[{"date":"2021-06-02","capi":"100 万人民币","type":"货币"}],"realCapiItems":[]}],"changeRecords":[{"changeItem":"章程备案","changeDate":"2021-07-15","beforeContent":"-","afterContent":"同意启用新章程","tag":"非历史信息","type":"章程备案变更"}],"socialSecurity":[{"reportYear":"2024","reportDate":"2025-03-18","insuranceNum":"3人","basicEndownmentNum":"3人","unenploymentNum":"3人","injuryInsuranceNum":"3人","birthNum":"0人"}],"apiCode":"enterprise.detail","apiName":"企业详细信息综合查询","chargeType":"PER_CALL","balance":99.4800,"costMs":1860}}

查不到（不收费）：

{"code":500,"msg":"未查询到该企业的详细信息，请核对企业名称或更换统一社会信用代码后重试；本次调用不计费","data":null}

六、可直接复用的两段代码

6.1 准入初筛：状态 + 规模 + 股东

defpre_check(data:dict)->dict:"""返回一份可读的准入结论"""basic=data["basicInfo"]partners=data.get("partners")or[]social=data.get("socialSecurity")or[]latest=social[0]ifsocialelse{}return{"name":basic.get("name"),"credit_no":basic.get("creditNo"),"status":basic.get("newStatus"),"alive":basic.get("newStatus")=="存续","regist_capi":basic.get("registCapi"),"legal_person":basic.get("operName"),"partner_count":len(partners),"staff_hint":latest.get("insuranceNum"),"risk":[]ifbasic.get("newStatus")=="存续"else["经营状态异常"],}

6.2 变更记录里找敏感变动

SENSITIVE={"股东股权变更","注册资金变更","人员变更","住所变更","经营范围变更"}defsensitive_changes(data:dict):"""挑出需要人工复核的变更事项"""rows=data.get("changeRecords")or[]return[rforrinrowsifr.get("type")inSENSITIVE]

七、实践建议

1. 关键词优先用信用代码。18 位信用代码唯一，名称要精确匹配全称，模糊查不到。
2. 超时至少 15 秒。接口要向多个维度取数，典型 1 ~ 3 秒，costMs会告诉你真实耗时。
3. 本地缓存结果。工商数据变动不频繁，按企业缓存 30 ~ 90 天，重复查询直接读库，省下 0.52 元/次。
4. -不要当空值处理成 0。termEnd = -是「长期」，转成 0 会算出「已过期」的错误结论。
5. stockPercent是小数。1.0表示 100%，展示时乘 100。
6. 参保人数只作参考。很多企业选择不公示金额字段，参保人数是「3人」这种带单位的文本。
7. 复用creditNo做主键。企业名称可能变更（historyNames会记录），信用代码不会变。
8. 查不到不收费，可以放心重试。但重试前先确认名称是否准确，避免无效调用堆积。

八、错误码与排查

结算判定很简单：只有basicInfo.name有值时才扣费。其余所有失败分支都不产生费用。

九、计费与接入

接入流程：注册开发者账号 → 控制台创建 API Key → 请求头带上X-API-Key即可调用，无需签名或加密。控制台可查看调用量、扣费流水与余额。

服务站点：api.xujian.tech（纯文本域名，不做跳转）。接口试用、数据与充值咨询可在控制台提交工单，或联系 Vxujian_cq。

十、小结

一个关键词换回四个维度的结构化数据，省掉的是「查四遍、拼四套、口径还要自己对齐」的工作量。几个取舍值得记住：

• 查不到不收费：先校正名称再查，试错成本是 0；
• -是业务占位：表示未公示 / 长期 / 无值，别当成 0 参与计算；
• 信用代码是最佳主键：名称会变，代码不变；
• 缓存价值高：工商数据低频变动，缓存一次能省下不少调用成本。

同系列还有：enterprise.query（0.01 元/次，名称模糊查询，适合先校正全称）、enterprise.profile（0.2 元/次，只要 33 项照面）、enterprise.abnormal与enterprise.dishonesty（各 0.2 元/次，经营异常与失信记录）、enterprise.report（0.3 元/次，多年度工商年报）。按需组合，比一律查最贵的接口更划算。