展会-搜展馆列表

接口说明

  • 查询展馆信息列表
  • 按照接口返回结果数量计费,计费量在参数usedCharge

API路径

/services/v4/rest/enterprise/exhibitionHallSearch

请求方法

POST

请求参数

body 参数

参数 类型 说明 示例
condition object 搜索条件  
page int 页数(默认为1)  
size int 每页数量(默认为10,最大值为20)  

搜索条件(condition)

参数 类型 说明 示例 是否必须
keyword string 关键词 建筑 否
exhHallStartDate array 开展时间(时间戳毫秒值),需要使用数组包裹 [“1705161599000:1713023999000”] 否
hallProvince array 展馆地区(省code) [ “11” ] 否
hallCity array 展馆地区(市code) [ “4451” ] 否
hallCountry array 展馆地区(国家,目前只有中国) [ “CN” ] 否
exhHallAreaSize array 展馆面积(数字) [“1000,5000”]表示大于等于1000,小于5000 否

国内省市区配置详见

调用样例

http://${host}/services/v4/rest/enterprise/exhibitionHallSearch

返回结果

字段 类型 说明
hallId string 展馆id
hallName string 展馆名称
hallSite string 展馆官网
hallInfo string 展馆信息
hallAddr string 展馆地址
hallArea string 展馆面积
opAgency array 运营机构数组,运营机构有两个字段:opAgencyName(机构名称)、opAgencyPid(机构关联工商的唯一标识,可能为null)
hallLogoUrl string 展馆logo url
hallHoldExhCount string 展馆举办展会次数

JSON示例

{
    "error_code": 0,
    "message": "",
    "data": [ // 展馆数据
        {
            "hallId": "vewet324gew", // 展馆id
            "hallName": "深圳xxx会展中心", // 展馆名称
            "hallSite": "http://www.fqeworld.com/", // 展馆官网
            "hallInfo": "一期工程总建筑面积达158万平方米,南北长1.8公里,相当于6个鸟巢。",  // 展馆信息
            "hallAddr": "广东省深圳市xxx路1号", // 展馆地址
            "hallArea": "500000平方米", // 展馆面积
            "opAgency": [ // 运营机构
                {
                    "opAgencyName": "深圳市xxx有限公司", // 运营机构名称
                    "opAgencyPid": "xxf3r312r" // 运营机构关联工商唯一标识
                }
            ],
            "hallLogoUrl": "https://oss-exhibition.lingxiaodata.com/dcwao/cavqefws.jpg", // 展馆logo url
            "hallHoldExhCount": 929 // 展馆举办展会次数
        }
    ],
    "total": 861,
    "page": 1,
    "size": 10,
    "usedCharge": 10
}

错误返回值

code msg 说明
 406  PIN已被使用 / 请求参数有误(keywords参数不能为空,类型需为string)  
407 PIN时间戳和服务器时间误差超过10分钟
408 Access Secrect 验证失败
409 缺少 X-AK-KEY 或者 X-AK-PIN 或 X-AK-TS 请求头
410 Access Key 不存在
411 访问 IP 不在白名单之列
412 Access Key 已被禁用
500 服务器错误
1000 账户已过期
1001 请求额度不足
1002 账户无调用权限
1003 请求并发超限

错误代码参考 错误码定义

文档更新时间: 2026-09-15 16:36   作者:3413