接口说明
按全称、注册号或统一社会信用代码查询登记信息。提交企业名称或统一社会信用代码(company,必填)、查询类型(type,可选)。返回工商公开登记或任职记录,不能代替营业执照原件。
请求方式
| 请求地址 | https://sowk.xingsuqy.com/v1/query/en-std |
|---|---|
| 请求方法 | POST |
| Content-Type | application/json |
| 鉴权 | 请求头 X-API-Key |
请求参数
| name | type | required | desc |
|---|---|---|---|
| company | string | 是 | 企业名称或统一社会信用代码 |
| type | string | 否 | 查询类型 |
返回参数
data 字段结构如下,外层为统一响应结构(见开发文档)。
| name | type | desc |
|---|---|---|
| name | string | 企业名称 |
| credit_code | string | 脱敏信用代码 |
| legal_person | string | 脱敏法定代表人 |
| status | string | 状态 |
| registered_capital | string | 注册资本 |
| established_at | string | 成立日期 |
请求示例
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": "示例值"
}
}错误码
| code | HTTP | 说明 | 处理建议 |
|---|---|---|---|
| 0 | 200 | 成功 | — |
| 400 | 400 | 参数缺失或格式错误 | 检查 message 指出的参数 |
| 401 | 401 | API Key 缺失或无效 | 在控制台核对 Key |
| 1002 | 402 | 该接口无可用次数 | 联系客服开通 |
| 1003 | 403 | 该接口未对当前账户开通 | 联系客服开通 |
| 404 | 404 | 接口不存在 | 核对接口编号 |
| 429 | 429 | 超出频率限制 | 按 Retry-After 重试 |
计费说明
本页为接口参考报价。具体套餐、计费口径与开通范围请在申请时确认;提交申请不会扣费。
连接检查
可先检查本站网关是否可达。此检查不查询业务数据、不需要 API Key,也不代表已取得当前接口权限。
curl https://sowk.xingsuqy.com/v1/status
收到 code=0、service=xingsu 表示网关响应正常;正式查询请按上面的请求参数,在服务端使用自己的 API Key。