企业信息模糊查询API

提供企业名称模糊查询功能,支持分页返回企业列表(含统一社会信用代码、法定代表人、企业状态等)

API 基本信息

API 端点
api/company_search_api.php
请求方法
POST / GET / JSON
认证方式
API Key(仅需 api_key)
响应格式
JSON

错误码说明

错误码 错误信息 说明
0 success 查询成功
1001 缺少必要参数 未提供 username / api_key / keyword 参数
1002 参数验证失败 关键词过短或格式校验失败
1003 用户名或API密钥无效 认证失败
1004 权限不足或调用次数不足 账户已过期
1005 操作失败 上游服务返回异常或查询失败
5000 系统内部错误 服务器异常

注意事项

  1. API 调用需要有效的 API 密钥,请在用户中心获取并妥善保管。
  2. 认证仅需提供 api_key 参数,支持 Header / JSON Body / POST Form / GET 多种传递方式。
  3. 查询关键词至少需要 2 个字符,否则会返回参数验证失败错误。
  4. 每页条数上限为 50,超过会被自动限制为 50,防止恶意拉取大量数据。
  5. 上游服务超时时间为 15 秒,超时会返回操作失败错误。
  6. 返回的企业状态包括但不限于:在营(开业)、注销、吊销、停业等。
  7. 成立日期格式为 yyyyMMdd(如 20150409 表示 2015年4月9日)。