根据企业英文名称查询企业信息v4
API路径
/services/v4/rest/enterprise/getEntInfoByEngName
请求方法
GET
请求参数
| 参数 | 类型 | 说明 | 示例 |
|---|---|---|---|
| engName | string / string[] | 必须,企业英文名称。支持单个字符串或数组,最多20个 |
调用样例
单个查询:https://{host}/services/v4/rest/enterprise/getEntInfoByEngName?engName=HUAWEI TECHNOLOGIES CO.,LTD.
批量查询:https://{host}/services/v4/rest/enterprise/getEntInfoByEngName?engName[]=HUAWEI TECHNOLOGIES CO.,LTD.&engName[]=XIAOMI INC.
返回结果JSON示例
{
"error_code": 0,
"success": true,
"message": "",
"data": [
{
"queryKey": "HUAWEI TECHNOLOGIES CO.,LTD.",
"pid": "abc123def456",
"entName": "华为技术有限公司",
"uncid": "914403001922038216"
}
]
}
未查到企业时:
{
"error_code": 0,
"success": true,
"message": "",
"data": []
}
未在数据库中匹配到的企业记录不会出现在返回结果中。
响应结构
| 字段名 | 类型 | 说明 |
|---|---|---|
error_code |
number | 错误码,0 表示成功 |
success |
boolean | 是否成功 |
message |
string | 错误信息 |
data |
array | 企业信息列表 |
data[].queryKey |
string | 查询使用的英文名称原文 |
data[].pid |
string | 企业 PID |
data[].entName |
string | 企业中文名称 |
data[].uncid |
string | 统一社会信用代码 |
错误响应示例
{
"error_code": 406,
"success": false,
"message": "参数错误"
}
错误码
| error_code | 说明 |
|---|---|
| 0 | 成功 |
| 406 | 参数错误(缺少参数、类型错误、数量超出1-20范围) |
| 500 | 服务器内部错误 |
业务逻辑说明
- 按
engName字段精确匹配查询,不支持模糊搜索 - 同一英文名称对应多条企业记录时,优先返回营业状态为「存续/在业」的企业
- 未在数据库中匹配到的企业记录不会出现在返回结果中
文档更新时间: 2026-09-13 20:40 作者:004