展会-搜展馆列表

接口说明

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

API路径

/services/v4/rest/enterprise/exhibitionHallSearch

请求方法

POST

请求参数

body 参数

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

搜索条件(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-03-27 08:49   作者:3413