alibaba.damai.mz.venue.info.get (场馆信息API)

麦座票务系统-自建电商网站-场馆信息API; 1、根据场馆id获取场馆信息; 2、场馆信息包含是否为大场馆字段,若为大场馆同时项目为选座项目时,获取座位列表时必须按(场次+看台)获取,不能按场次直接获取所有座位(避免数据量过大);

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
venue_id String 必须 9876631012 场馆id
event_id Number 可选 324232 演出场次ID(分销查询生产方场馆时必传)

响应参数

名称 类型 示例值 描述
result ResultData api返回结果
  • └ msg
  • String
  • 成功
  • 提示
  • └ code
  • String
  • 200
  • 状态码
  • data
  • VenueInfoVO
  • 场馆信息
  • └ city_name
  • String
  • 北京市
  • 市名称
  • └ city_code
  • Number
  • 110000
  • 市代码;国标6位,中国民政部行政区划代码
  • └ province_name
  • String
  • 北京市
  • 省名称
  • └ province_code
  • Number
  • 110000
  • 省代码;国标6位,中国民政部行政区划代码
  • └ latitude
  • String
  • 39.910925
  • 纬度,高德地图坐标
  • └ longitude
  • String
  • 116.413384
  • 经度,高德地图坐标
  • └ venue_img_url_list
  • String []
  • http://xxx.jpg
  • 场馆俯瞰图url 列表
  • └ venue_introduce
  • String
  • 世纪剧院是具有90年代先进水平的高档剧院。剧院以上演大型歌剧、 话剧、芭蕾舞剧为主,同时也为上演大型交响乐提供了先进的反音设备。它是目前国内设计最先进、设备最完善、综合条件最好的剧院。
  • 场馆简介;格式:富文本
  • └ venue_name
  • String
  • 北京世纪剧院
  • 场馆名称
  • └ venue_id
  • String
  • 9876631012
  • 场馆id
  • └ address
  • String
  • 朝阳区xxx大街xx号北京世纪剧院
  • 场馆详细地址
  • └ big_venue_boolean
  • Boolean
  • true
  • 是否为大场馆,true=是,false=否;若为大场馆,项目座位购买类型为自助选座时,调用获取座位列表接口时入参“看台id”为必填,需按看台分批获取座位;避免单次获取商品数量过大;此值为场馆基础属性,一般不会改变;
  • └ success
  • Boolean
  • true
  • api请求是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiMzVenueInfoGetRequest req = new AlibabaDamaiMzVenueInfoGetRequest();
req.setVenueId("9876631012");
req.setEventId(324232L);
AlibabaDamaiMzVenueInfoGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_damai_mz_venue_info_get_response>
    <result>
        <msg>成功</msg>
        <code>200</code>
        <data>
            <city_name>北京市</city_name>
            <city_code>110000</city_code>
            <province_name>北京市</province_name>
            <province_code>110000</province_code>
            <latitude>39.910925</latitude>
            <longitude>116.413384</longitude>
            <venue_introduce>世纪剧院是具有90年代先进水平的高档剧院。剧院以上演大型歌剧、 话剧、芭蕾舞剧为主,同时也为上演大型交响乐提供了先进的反音设备。它是目前国内设计最先进、设备最完善、综合条件最好的剧院。</venue_introduce>
            <venue_name>北京世纪剧院</venue_name>
            <venue_id>9876631012</venue_id>
            <address>朝阳区xxx大街xx号北京世纪剧院</address>
            <big_venue_boolean>true</big_venue_boolean>
        </data>
        <success>true</success>
    </result>
</alibaba_damai_mz_venue_info_get_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
40100000 api未知错误 通用系统异常
40100001 api请求失败 通用业务异常
40100002 请求必须的参数不能为空 请求必须的参数不能为空
40100003 请求数据不存在 请求数据不存在
40100004 非法的appkey,请联系麦座小二 非法的appkey,请联系麦座小二
40100007 appkey商户配置不存在,请联系麦座小二 appkey商户配置不存在,请联系麦座小二
40100008 出参数据不符合规范,请联系麦座小二 出参数据不符合规范,请联系麦座小二
40100009 接口超时,请稍后重试 接口超时,请稍后重试

API工具

如何获得此API

FAQ

返回
顶部