根据企业英文名称查询企业信息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