企业注册、供应商录入和客户资料补全都需要可靠的公司搜索。轻语企业查询API通过
POST /data/api/searchCompany接收公司名称或信用代码，返回候选企业的基础工商字段。
一、企业查询API适合做什么
接口适合做企业名称联想、供应商资料预填、客户搜索和后台运营工具。它解决的是“快速找到候选企业并展示基础信息”，不是替代尽职调查或直接生成合规结论。业务侧应保存查询时间、关键词和用户操作记录。
| 输入 | 返回字段 | 常见用途 |
|---|---|---|
| 公司名称片段 | 公司全称、法人、注册日期、统一信用代码 | 搜索联想与资料预填 |
| 统一社会信用代码 | 精确候选与基础信息 | 供应商去重与档案匹配 |
| 空值或过短文本 | 参数错误 | 前端直接拦截，减少无效调用 |
二、最小请求示例
curl -X POST 'https://5555api.com/data/api/searchCompany' \
-H 'Content-Type: application/json' \
-d '{"apikey":"YOUR_APIKEY","text":"上海栾青网络科技"}'const response = await fetch('https://5555api.com/data/api/searchCompany', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
apikey: process.env.QINGYU_API_KEY,
text: keyword.trim()
})
});
const result = await response.json();
if (result.code !== 200) throw new Error(result.msg || '企业查询失败');三、搜索框的交互设计
不要在每个键盘事件都调用接口。推荐至少满足三个条件后再查询：输入长度达到业务最小值、用户停止输入一小段时间、当前关键词与上一次不同。候选列表展示公司全称和统一信用代码，用户选中后再回填表单。
let timer;
searchInput.addEventListener('input', () => {
clearTimeout(timer);
const keyword = searchInput.value.trim();
if (keyword.length < 2) return renderEmpty();
timer = setTimeout(() => searchCompany(keyword), 350);
});四、数据展示与合规边界
- 把公司全称作为主标题，法人、成立日期和信用代码作为辅助信息。
- 对缺失字段显示“暂无数据”，不要把undefined直接渲染到页面。
- 注明数据来源与查询时间；关键流程保留人工确认按钮。
- API Key只放在服务端，前端只收到业务系统自己的查询结果。
五、常见错误处理
关键词为空、apikey错误、余额不足和频率超限应分别提示。对短暂网络失败可以重试一次；对相同关键词可以短时缓存，减少重复扣费。不要把企业查询响应完整写入公开日志。
六、继续阅读
接口字段和多语言示例请查看企业查询API文档。如果业务还要做地址标准化，可结合地理编码API实践，把企业地址转换为坐标用于地图展示。
常见问题
企业查询API支持哪些关键词？
可以传公司名称片段或统一社会信用代码进行模糊搜索。输入越完整，候选结果越容易缩小。
企业查询结果可以直接作为风控结论吗？
不能。接口结果适合检索和业务预填，关键决策仍应结合官方公示信息、授权范围和业务复核流程。
如何避免搜索框频繁调用接口？
前端可以在用户停止输入后再请求，并对相同关键词做短时缓存；提交前同时校验apikey、余额和频率限制。
结语
企业查询API的稳定接入依赖清晰的搜索交互、字段容错和合规提示。先把候选搜索做准确，再将结果接入供应商、客户或运营流程，能比一次性设计复杂风控链路更容易维护。