单个演出及商品信息查询

该接口用于演出及商品信息同步,会包含演出的场次、票档以及对应商品的价格、库存等信息。

GET /openapi/v2/activities/detail{?activityId,sign,appId,timeStamp}

参数 :

name 意义 取值
sign 签名 923E7DC7513AFBB7F3A22171063663D7
appId 代理商的唯一id 1
timeStamp 时间戳,请取发送请求的当前时间 有效期10分钟 1482991236008
activityId 演出ID 1
请求示例(测试环境):
   curl 'http://openapibeta.piaoniu.com/openapi/v1/activities/detail?appId=10001&activityId=1041&timeStamp=1509691330432&sign=E80F14A488AD87FB7AD45FD7E133AF33'

返回值 :

示例:
      {
          "id": 3167,
          "status": 1,  //演出状态 0: "已删除",1: "售卖中",2: "暂停售卖",3: "已过期",4: "预订中",5: "退票中",6:"待开售"
          "name": "奇迹— 女子十二乐坊2017上海专场音乐会",
          "poster": "http://7xllta.com1.z0.glb.clouddn.com/perform/project/977/97797_n.jpg",
          "areaImage":"https://img.piaoniu.com/areaImg/f2bb7e908518dd21d5a83e018d2f5a4b2025f56b.jpg?imageView/2/w/800/h/800/format/jpg", //座位图,可空
          "venueId": 101,  //场馆id
          "categoryId":2, //类目id
          "star":8, // 评分,分数为1-10分,0表示数据不足无评分
          "venue": {
              "id": 1,
              "name": "人民大舞台",
              "address": "上海黄浦区九江路663号",
              "cityId": 1
          },
          "details": [
              {
                  "type": 2,  //类型 1: "简介",2: "详情",4: "一句话简介",5"购买须知"
                  "detailDesc": "演出详情"
              },
              {
                  "type": 1,
                  "detailDesc": "演出简介"
              },
              {
                  "type": 4,
                  "detailDesc": "一句话简述"
              },
              {
                  "type":5,
                  "detailDesc":"购买须知:只可大人使用"
              }
          ],
          "activityEvents": [
              {
                  "id": 19469,
                  "specification": "2017年03月04日 星期六 19:30",
                  "start": 1488627000000,
                  "end": 1488634200000,
                  "status": 1,   //0: "已删除",1: "售卖中",2: "暂停售卖",3, "已过期",5:"尾票阶段(可正常售卖,但是不提供快递配送方式,第三方不需要消费此状态,以deliverTypes为准)"
                  "ticketCategories": [
                      {
                          "id": 119873,
                          "originPrice": 800,   //票档原价
                          "specification": "800",
                          "description":"每位成人可免费携带一名1米以下儿童入场", //可空,票档补充信息
                          "activityEventId": 19469,
                          "status": 1, //1有效
                          "ticketGroup": {
                              "ticketCategoryId": 119873,
                              "ticketGroupId": 86847, //商品id
                              "salePrice": 808,  //售价
                              "isPremium":1,//1 溢价,2 平价,3 折扣
                              "premiumPrice":8,//表示票档溢价部分的价格,默认0
                              "selling": 2,  //在卖数量
                              "eticketProvider":1, //1 :票牛方发券,2:供应商发券
                              "priceList":[
                                 808,1280 //
                              ]
                              "deliverTypes": [{
                                 "type": 1 //快递
                              },{
                                 "type": 3 //现场自取
                              }]
                          }
                      },
                      {
                          "id": 119874,
                          "originPrice": 180,
                          "specification": "180",
                          "activityEventId": 19469,
                          "status": 1,
                          "ticketGroup": {
                              "ticketCategoryId": 119874,
                              "ticketGroupId": 86848,
                              "salePrice": 182,
                              "isPremium":1,//1 溢价,2 平价,3 折扣
                              "premiumPrice":2,//表示票档溢价部分的价格,默认0
                              "selling": 6,
                              "eticketProvider":1, //1 :票牛方发券,2:供应商发券
                              "priceList":[
                                  182,364,546,728,910,1092 //组合报价,详情见[商品库存及价格查询]
                              ]
                              "deliverTypes": [{
                                 "type": 1 //快递
                              },{
                                 "type": 3 //现场自取
                              },{
                                 "type": 5 //电子票
                              }]
                          }
                      }

                  ]
              }
          ],
          "needIdCard":true, //是否需要身份证
          "idCardLimitType":1, //1一单一证,2一票一证
          "idCardUseTime":1, //一张身份证在这个场次可以买几张票(需要身份证的时候才需要消费)
           "orderNumLimit": {
               "numMin": 1, // 购买最小数量, 为0时无意义
               "numMax":6, // 购买最大数量, 为0时无意义, 需要结合ticketGroup的库存判断
               "orderLimit":0 // 订单总数限制, 为0时无意义, 根据手机号判断, 可无视
           },
           "specialInfo":{ // 观演须知
               "enterTips":[ // 普通观演须知
                   {
                       "title": "演出语言",
                       "desc": "中文",
                       "type": 3
                   }
               ],
               "ticketTips":[
                   {
                        "title":"实体票",
                        "desc":“本项目支持凭实体票入场,支持以下取票方票...",
                           "type": 10
                   }
           }
           "weight":299 //演出热度,一般越大的越靠前
      }
观演须知类型
(1, "儿童入场提示"),
(2, "禁止携带物品"),
(3, "演出语言"),
(4, "演出形式"),
(5, "演出时长"),
(6, "入场时间"),
(7, "限购说明"),
(8, "座位类型"),
(9, "用券限制"),
(10, "实体票"),
(11, "电子票"),
(99, "其他说明");

变更历史

name 时间 内容
v1.3 2024-01-10 新增结构化观演须知字段specialInfo
v1.2 2024-01-03 新增演出限购字段
v1.1 2019-10-25 渠道定制字段

results matching ""

    No results matching ""