展会-搜展馆列表
接口说明
- 查询展馆信息列表
- 按照接口返回结果数量计费,计费量在参数
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