企业工商照面查询接口（enterprise.profile）：33 项工商登记信息

这个接口能解决什么问题

enterprise.profile 是核实企业身份最省钱的接口：只返回工商照面 33 项，不含股东、变更、社保等扩展维度（需要全景数据请用 enterprise.detail）。适用于开票信息补全、供应商身份核实、CRM 建档补资料等只需要「确认这家企业是谁」的场景。

一句话说明

输入企业全称 / 注册号 / 统一社会信用代码，返回工商照面 33 项；查得计费，查不到不收费。

适用场景

开票 / 建档：拿到准确全称与统一社会信用代码回填表单
供应商 / 客户身份核实：确认企业真实存在与基本状态
CRM 主数据初始化：批量补全工商登记字段
经营状态核对：确认企业是否存续、吊销或注销

接口规格

接口规格
请求地址	`https://api.xujian.tech/openapi/enterprise/profile`
请求方式	GET（keyword 放 Query String）
鉴权方式	请求头 `X-API-Key`
接口编码	`enterprise.profile`
收费类型	按次计费（PER_CALL，0.2000 元/次）
计费规则	查得计费：关键词非法、上游不可用、查不到该企业时失败且不扣费
返回字段	工商照面 33 项
典型用途	开票补全、身份核实、CRM 建档、状态核对

如何调用

cURL

curl -s -G "https://api.xujian.tech/openapi/enterprise/profile" --data-urlencode "keyword=重庆可乐家装饰工程有限公司" -H "X-API-Key: 你的APIKey"

返回示例（节选，code = 0）

JSON

{
  "code": 0,
  "msg": "success",
  "data": {
    "name": "重庆可乐家装饰工程有限公司",
    "creditNo": "91500113MAABRA7D0H",
    "regNo": "500113014353471",
    "status": "存续（在营、开业、在册）",
    "newStatus": "存续",
    "operName": "李伦智",
    "registCapi": "100 万人民币",
    "econKind": "有限责任公司",
    "startDate": "2021-06-02",
    "belongOrg": "重庆市巴南区市场监督管理局",
    "apiCode": "enterprise.profile",
    "apiName": "企业工商照面信息查询",
    "chargeType": "PER_CALL",
    "balance": 99.8000,
    "costMs": 230
  }
}

计费说明

按次计费，0.2000 元/次。采用「先预鉴权、查得后扣费」两段式：关键词非法、上游不可用、查不到该企业时返回失败，不扣费；只有返回有效工商照面才计一次费用。

常见问题

和 enterprise.detail 有什么区别？ profile 只要 33 项工商照面（更便宜）；detail 额外返回股东、变更、社保，适合尽调与风控画像。
关键词怎么填？ 企业全称 / 注册号 / 统一社会信用代码，长度 2 ~ 50 字符；名称不准确时建议先用 enterprise.query 校正全称。
注册资本怎么解析？ registCapi 是「金额 + 空格 + 万 + 货币单位」字符串（如「1200 万人民币」），做数值比较时先提取数字并注意单位。