1. 功能介绍
票牛Open API提供以下能力,第三方接入商可以通过API同步票牛的演出和商品,并进行下单和支付,如下图:
2. 基本名词解释
name | 意义 |
---|---|
activity | 演出 |
activityEvent | 场次 |
ticketCategory | 票档 |
ticketGroup | 商品 |
说明 :
- 演出activity是商品聚合和查询的单位,例如:"2017五月天LIFE[人生无限公司]巡回演唱会 广州站"
- 演出可能会有多个场次activityEvent,例如:"2017年03月25日 周六 18:30"和"2017年03月26日 周日 18:30"
- 场次会有多个票档ticketCategory,例如:"2017年03月25日 周六 18:30"会有"看台255"、"看台355"、"看台455"、"看台655"、"内场855"、"内场1055"、"内场1355"7个票档
- ticketGroup是票牛定义的商品,对应一个票档下某个卖家售卖的商品,需要在创建订单时传入
- 每个票档只会推送一个商品,但是每次通过票档拿到的ticketGroupId可能不同,需要在同步时进行更新
3. 接入指引
进行开发前,请务必阅读API规范。
主要API及用途如下:
API | 用途 |
---|---|
演出及商品信息查询 | 用于全量同步演出和商品,影响新商品上架,建议同步周期一天以内 |
商品库存及价格查询 | 用于增量同步库存和价格,影响已有商品售卖,建议同步周期2小时 |
创建订单 | 创建订单 |
支付订单 | 支付订单 |
查询订单 | 查询订单,用于同步订单状态,建议同步周期1小时 |
4. 变更历史
name | 时间 | 内容 |
---|---|---|
V2.5 | 2019-05-22 | 选座更新,取消订单 |
V2.4.4 | 2019-04-29 | 选座信息 |
V2.4.3 | 2018-01-04 | 增加演出热度 演出信息查询 |
V2.4.2 | 2017-11-23 | 增加订单的发货时间提示信息 订单信息查询 |
V2.4.1 | 2017-11-7 | 增加票档的补充说明字段description 演出信息查询 |
V2.4 | 2017-11-3 | 增加单个演出的信息查询 演出信息查询 |
V2.3 | 2017-11-1 | 增加快递订单的物流信息查询 订单信息查询 |
V2.2.1 | 2017-10-17 | 演出增加评分数据 演出批量信息查询 |
V2.2 | 2017-9 | 商品增加组合报价功能,通过TicketGroupDTO的priceList字段来提供,详细描述见 商品库存及价格查询 |
V2.1 | 2017-7 | 商品和下单增加配送方式,可支持现场取票的订单,增加订单取票信息快递信息 |
V2.0 | 2017-3 | 订单接口增加错误类型 |
V1.0 | 2016-12 | 第一版,同步演出、库存,以及订单相关接口 |