企业工商查询 API 接入文档
在首页注册并登录,在控制台创建 API Key。请将密钥保存在自己的服务端,不要写入公开网页或公开代码仓库。
企业名称模糊搜索
GET https://api.axiomcloud.cn/v1/company/search
| 参数 | 位置 | 说明 |
|---|---|---|
| x-api-key | 请求头 | 控制台创建的有效 API Key |
| keyword | 查询参数 | 必填,企业名称搜索关键词 |
| skip | 查询参数 | 可选,分页偏移量,默认为 0 |
curl 请求示例
curl --get 'https://api.axiomcloud.cn/v1/company/search' \
--header 'x-api-key: YOUR_API_KEY' \
--data-urlencode 'keyword=腾讯' \
--data-urlencode 'skip=0'将 YOUR_API_KEY 替换为自己的密钥。成功响应包含 success、code、data 和 billing;data 为查询结果,billing.remaining 为剩余可用次数。业务代码应检查返回状态,不能假定每次都能匹配到企业。
剩余额度查询
curl 'https://api.axiomcloud.cn/v1/account/quota' \
--header 'x-api-key: YOUR_API_KEY'成功返回 data.remaining 和 data.packages。额度查询不会扣减企业搜索次数。
计费与错误处理
- 查询成功扣减 1 次;失败不扣减。
- 400:请求参数错误,请检查 keyword。
- 401:密钥无效或已撤销,请在控制台检查密钥。
- 402:无可用套餐,请购买或检查套餐有效期。
- 502 或上游错误:服务请求失败,请检查响应信息并稍后重试。
成功请求重复调用会再次计次,请避免无意义的重复请求。查看套餐价格。