展会-行业专栏-展会偏好

接口说明

  • 展会行业版-查询企业行业专栏中的展会偏好信息

API路径

/services/v4/rest/enterprise/exhibitionPreferences

请求方法

GET

请求参数

参数 类型 说明 示例
keywords string 企业唯一标识或者公司名称,统一信用代码,工商注册码 xxx太阳能电力有限公司
module string 展会偏好信息模块 RecommendedExhibition
page int 分页参数-页码,默认为1,目前只对ExhibitionInfo模块有效
pageSize int 分页参数-每页数量,默认为10,最大值为50,目前只对ExhibitionInfo模块有效

展会信息模块如下:

  • RecommendedExhibition:推荐展会(固定返回4个推荐的展会信息)
  • ExhibitionFrequency:参展频率(参加过展会的频率分析)
  • ExhibitionClass:参展类型(参加过展会的类型分析)
  • ExhibitionAddress:参展地区(参加过展会的地区分析)
  • ExhibitionInfo:参展信息(参加过的展会信息)

展会与会刊定义:

  • 展会:如 中国广电博览会 ,可以有多届,如 第三届中国广电博览会
  • 会刊:如 第三届中国广电博览会,表示具体的一次展会

调用样例

http://${host}/services/v4/rest/enterprise/exhibitionPreferences?keywords=xxx太阳能电力有限公司

返回结果

JSON示例

{
  "error_code": 0,
  "success": true,
  "message": "",
  "data": {
    "selfInfo": { // 查询企业的信息
      "pid": "41e1af622xxxxe4fd96253e", // 企业唯一标识
      "entName": "xxx太阳能电力有限公司", // 企业名称
      "uncid": "vcqf4213t", // 企业的统一社会信用码
      "regno": "tr31edwad3", // 企业注册号
      "esDate": 980092800000 // 企业注册时间
    },
    "data": {
      "ExhibitionAddress": [ // 参展地区(参加过展会的地区分析),这里固定返回-上海/北京/广东/重庆/国外 这几个的数据,其余地区则放入其他的subRegion中
        {
          "region": "上海", //地区
          "count": 6, // 次数
          "percentage": 14.63 // 占比
        },
        {
          "region": "北京",
          "count": 24,
          "percentage": 58.54
        },
        {
          "region": "广东",
          "count": 3,
          "percentage": 7.32
        },
        {
          "region": "重庆",
          "count": 1,
          "percentage": 2.44
        },
        {
          "region": "国外",
          "count": 0,
          "percentage": 0,
          "subRegion": []
        },
        {
          "region": "其它",
          "count": 7,
          "percentage": 17.07,
          "subRegion": [ // 除 上海/北京/广东/重庆/国外 外的其他地区分析
            {
              "region": "广西-南宁", //地区
              "count": 5 //次数
            },
            {
              "region": "天津",
              "count": 1
            },
            {
              "region": "江苏-苏州",
              "count": 1
            }
          ]
        }
      ],
      "ExhibitionFrequency": [ // 参展频率(参加过展会的频率分析):返回的年份是固定的
        {
          "year": "2019年及以前", //年份
          "count": 24, // 次数
          "specialCount": 20, // 特装次数
          "percentage": 83.33 // 占比
        },
        {
          "year": "2020年", 
          "count": 1,
          "specialCount": 1,
          "percentage": 100
        },
        {
          "year": "2021年",
          "count": 4,
          "specialCount": 3,
          "percentage": 75
        },
        {
          "year": "2022年",
          "count": 3,
          "specialCount": 2,
          "percentage": 66.67
        },
        {
          "year": "2023年",
          "count": 6,
          "specialCount": 4,
          "percentage": 66.67
        },
        {
          "year": "2024年",
          "count": 2,
          "specialCount": 0,
          "percentage": 0
        },
        {
          "year": "2025年",
          "count": 1,
          "specialCount": 0,
          "percentage": 0
        }
      ],
      "ExhibitionClass": [ // 参展类型(参加过展会的类型分析)
        {
          "kindCode": 3, // 参展类型code
          "kindName": "商贸综合", // 参展类型
          "count": 18 //参展次数
        },
        {
          "kindCode": 13,
          "kindName": "文教娱乐",
          "count": 8
        },
        {
          "kindCode": 8,
          "kindName": "电子软件",
          "count": 4
        },
        {
          "kindCode": 18,
          "kindName": "其他展会",
          "count": 4
        },
        {
          "kindCode": 4,
          "kindName": "工业制造",
          "count": 2
        },
        {
          "kindCode": 9,
          "kindName": "能源电力",
          "count": 2
        },
        {
          "kindCode": 15,
          "kindName": "旅游运输",
          "count": 1
        },
        {
          "kindCode": 2,
          "kindName": "五金建材",
          "count": 1
        },
        {
          "kindCode": 5,
          "kindName": "药品保健",
          "count": 1
        }
      ],
      "ExhibitionInfo": { // 参展信息(参加过的展会信息)
        "total": 35, // 参加展会总数量
        "items": [
          {
            "journalId": "xxxxxwd142343dw", // 会刊id
            "exhibitionId": "xxsaq", // 展会id 
            "journalName": "2025第八届xxx与成果展", // 会刊名称
            "journalClass": "能源电力", // 会刊类型
            "parType": [ // 参展身份: 1-主办方,2-承办方,3-参展商
              3
            ],
            "isSpecial": 0, // 是否特装
            "journalStartDate": 1744041600000, //会刊开始时间
            "journalEndDate": 1744214400000, //会刊结束时间
            "journalRegion": "北京" // 开展地区
          },

        ]
      },
      "RecommendedExhibition": [ // 推荐展会
        {
          "journalId": "r3r3r3r", // 会刊id
          "exhibitionId": "cwqrq", // 展会id
          "journalLogo": "https://oss-exhibition.lingxiaodata.com/prod/exhibition-logo/ffceqfgq.jpg", // 会刊logo
          "journalName": "2025xxx贸易博览会", // 会刊名称
          "journalStatus": 0, // 开展状态 0 :未开始,1: 进行中, 2: 已结束
          "journalStartDate": 1765468800000, // 会刊开始时间
          "journalEndDate": 1765641600000 // 会刊结束时间
        }
      ]
    }
  }
}

当传入module为 ExhibitionInfo 时,只返回下面的数据,且受到page和pageSize参数的控制

{
  "error_code": 0,
  "success": true,
  "message": "",
  "data": {
    "selfInfo": { // 查询企业的信息
      "pid": "41e1af622xxxxe4fd96253e", // 企业唯一标识
      "entName": "xxx太阳能电力有限公司", // 企业名称
      "uncid": "vcqf4213t", // 企业的统一社会信用码
      "regno": "tr31edwad3", // 企业注册号
      "esDate": 980092800000 // 企业注册时间
    },
    "data": {
      "ExhibitionInfo": {
        "total": 35,
        "items": [
          {
            "journalId": "xccacsa",
            "exhibitionId": "vcegrew",
            "journalName": "2018年xxx展览会",
            "journalClass": "商贸综合",
            "parType": [
              3
            ],
            "isSpecial": 1,
            "journalStartDate": 1534953600000,
            "journalEndDate": 1535212800000,
            "journalRegion": "北京"
          },
        ]
      }
    }
  }
}

错误返回值

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 请求并发超限

错误代码参考 错误码定义

文档更新时间: 2025-12-10 19:17   作者:3413