提供企业名称模糊查询功能,支持分页返回企业列表(含统一社会信用代码、法定代表人、企业状态等)
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| api_key | string | 必填 | 用户API密钥 |
| action | string | 否 | 操作类型,默认 search,也可传 company_search |
| keyword | string | 必填 | 企业名称关键词(至少2个字符) |
| page_num | int | 否 | 页码,默认 1 |
| page_size | int | 否 | 每页条数,默认 20,上限 50 |
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码,0 表示成功 |
| message | string | 响应消息 |
| data | object | 上游返回的业务数据 |
| data.success | boolean | 上游查询是否成功 |
| data.code | int | 上游状态码 |
| data.data.orderNo | string | 查询订单号 |
| data.data.companyList | array | 企业信息列表 |
| data.data.companyList[].companyName | string | 企业名称 |
| data.data.companyList[].legalPerson | string | 法定代表人 |
| data.data.companyList[].creditNo | string | 统一社会信用代码 |
| data.data.companyList[].companyStatus | string | 企业状态(如:在营(开业)、注销等) |
| data.data.companyList[].establishDate | string | 成立日期(格式:yyyyMMdd) |
| data.data.pageInfo.totalRecords | string | 总记录数 |
| data.data.pageInfo.pageIndex | string | 当前页码 |
| data.data.pageInfo.pageSize | string | 每页条数 |
api_key: your_api_key)// JSON 请求示例 (application/json)
{
"api_key": "your_api_key",
"keyword": "蝶梦",
"page_num": 1,
"page_size": 20
}
// POST 请求示例 (application/x-www-form-urlencoded)
api_key=your_api_key&keyword=蝶梦&page_num=1&page_size=20
// GET 请求示例
api/company_search_api.php?api_key=your_api_key&keyword=蝶梦&page_num=1&page_size=20
// HTTP Header 请求示例(api_key 通过 Header 传递)
curl -X POST api/company_search_api.php \
-H "api_key: your_api_key" \
-H "Content-Type: application/json" \
-d '{"keyword":"蝶梦","page_num":1,"page_size":20}'
{
"code": 0,
"message": "查询成功",
"data": {
"msg": "成功",
"success": true,
"code": 200,
"data": {
"orderNo": "202608281035378402956",
"companyList": [
{
"companyCode": "440126000553091",
"companyName": "广州蝶梦网络科技有限公司",
"legalPerson": "刘玉勤",
"companyStatus": "注销",
"creditNo": "914401133314877303",
"establishDate": "20150409"
},
{
"companyCode": "411403000108693",
"companyName": "河南蝶梦网络科技有限公司",
"legalPerson": "刘梦蝶",
"companyStatus": "在营(开业)",
"creditNo": "91411403MA443YQJ8Q",
"establishDate": "20170627"
}
],
"pageInfo": {
"totalRecords": "1850",
"pageIndex": "1",
"pageSize": "20"
}
}
}
}
| 错误码 | 错误信息 | 说明 |
|---|---|---|
| 0 | success | 查询成功 |
| 1001 | 缺少必要参数 | 未提供 username / api_key / keyword 参数 |
| 1002 | 参数验证失败 | 关键词过短或格式校验失败 |
| 1003 | 用户名或API密钥无效 | 认证失败 |
| 1004 | 权限不足或调用次数不足 | 账户已过期 |
| 1005 | 操作失败 | 上游服务返回异常或查询失败 |
| 5000 | 系统内部错误 | 服务器异常 |