商品库存及价格查询
该接口用于已知票档后,同步最新的售价、库存等,该接口为批量接口。
GET /openapi/v2/tickets/batchDetails{?ids,sign,appId,timeStamp}
参数 :
name |
意义 |
取值 |
sign |
签名 |
483DFD2E8BE0AF2D486F04C7320C7C5E |
appId |
代理商的唯一id |
1 |
timeStamp |
时间戳 有效期10分钟 |
1482995969920 |
ids |
票档id ,通过 "," 分割,不超过100个 |
119877,119878 |
请求示例(测试环境):
curl 'http://openapibeta.piaoniu.com/openapi/v2/tickets/batchDetails?ids=207355,207356&sign=1B36ED676EFB0133EC42E8303E8C6DEF&appId=10000&timeStamp=1489756931881'
返回值 :
name |
意义 |
ticketGroupId |
商品id |
ticketCategoryId |
票档id |
salePrice |
商品售价 (单张售价,非组合报价使用此价格,总价格为salePrice*张数) |
selling |
在售数量 |
priceList |
(购买多张时的组合报价,组合报价的说明加本页末尾) |
组合报价 :
组合报价是一种特殊的报价形式,它会对购买同一商品的不同数量时给出不同价格。
在票牛的业务场景中,会存在这样的形式,例如:
- 如果有多个商家,一些商家价格有优势,一些商家库存有优势,那么会在选择不同库存时可能会给出不同商家的报价
- 商家设置了补贴,购买多张时价格会更低
组合报价可以有效提高库存的丰富度。接入方可以选择开启或者关闭组合报价。未开启组合报价时,将不会返回priceList字段。
开启后,需要在用户下单并选择数量后,传入对应数量的金额。例如下例中,用户购买207355票档4张,那么需要选择priceList[181,362,543,760,950]
中的第4个报价,即760传入。
示例:
[
{
"ticketCategoryId":207355,
"ticketGroupId":97977,
"salePrice":181,
"isPremium":1,
"premiumPrice":2,
"selling":5,
"promiseDeliverDay": 10,
"priceList":[
181,362,543,760,950
]
},
{
"ticketCategoryId":207356,
"ticketGroupId":97978,
"eticketProvider":1,
"salePrice":281,
"promiseDeliverDay": 10,
"isPremium":1,
"premiumPrice":2,
"selling":3,
"priceList":[
281,562,843
]
}
]
变更历史
name |
时间 |
内容 |
v1.1 |
2019-10-25 |
渠道定制字段 |