单个演出及商品信息查询
该接口用于演出及商品信息同步,会包含演出的场次、票档以及对应商品的价格、库存等信息。
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, //详见演出及商品详情接口的相关枚举-演出状态
"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, // 详见演出及商品详情接口的相关枚举-场次状态
"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 |
渠道定制字段 |