企业工商 POST /v1/query/en-std

企业工商信息标准查询

XS-API-EN-STD · ¥0.18 / 次

接口说明

按全称、注册号或统一社会信用代码查询登记信息。提交企业名称或统一社会信用代码(company,必填)、查询类型(type,可选)。返回工商公开登记或任职记录,不能代替营业执照原件。

请求方式

请求地址https://sowk.xingsuqy.com/v1/query/en-std
请求方法POST
Content-Typeapplication/json
鉴权请求头 X-API-Key

请求参数

nametyperequireddesc
companystring是企业名称或统一社会信用代码
typestring否查询类型

返回参数

data 字段结构如下,外层为统一响应结构(见开发文档)。

nametypedesc
namestring企业名称
credit_codestring脱敏信用代码
legal_personstring脱敏法定代表人
statusstring状态
registered_capitalstring注册资本
established_atstring成立日期

请求示例

curl -X POST https://sowk.xingsuqy.com/v1/query/en-std \
  -H "X-API-Key: xs_your_key" \
  -H "Content-Type: application/json" \
  -d '{"company":"示例科技有限公司","type":"all"}'

返回示例

以下为文档示例,不是本次实时查询结果。请勿把示例数据作为业务判断依据。

{
    "code": 0,
    "message": "success",
    "request_id": "20260919120000abc123",
    "data": {
        "name": "示例科技有限公司",
        "credit_code": "91**************XY",
        "legal_person": "张*",
        "status": "示例状态",
        "registered_capital": "示例值",
        "established_at": "示例值"
    }
}

错误码

codeHTTP说明处理建议
0200成功—
400400参数缺失或格式错误检查 message 指出的参数
401401API Key 缺失或无效在控制台核对 Key
1002402该接口无可用次数联系客服开通
1003403该接口未对当前账户开通联系客服开通
404404接口不存在核对接口编号
429429超出频率限制按 Retry-After 重试

计费说明

本页为接口参考报价。具体套餐、计费口径与开通范围请在申请时确认;提交申请不会扣费。

连接检查

可先检查本站网关是否可达。此检查不查询业务数据、不需要 API Key,也不代表已取得当前接口权限。

curl https://sowk.xingsuqy.com/v1/status

收到 code=0、service=xingsu 表示网关响应正常;正式查询请按上面的请求参数,在服务端使用自己的 API Key。