1. 功能介绍

票牛Open API提供以下能力,第三方接入商可以通过API同步票牛的演出和商品,并进行下单和支付,如下图:

架构图

2. 基本名词解释

name 意义
activity 演出
activityEvent 场次
ticketCategory 票档
ticketGroup 商品

演出名词及关系

说明 :

  1. 演出activity是商品聚合和查询的单位,例如:"2017五月天LIFE[人生无限公司]巡回演唱会 广州站"
  2. 演出可能会有多个场次activityEvent,例如:"2017年03月25日 周六 18:30"和"2017年03月26日 周日 18:30"
  3. 场次会有多个票档ticketCategory,例如:"2017年03月25日 周六 18:30"会有"看台255"、"看台355"、"看台455"、"看台655"、"内场855"、"内场1055"、"内场1355"7个票档
  4. ticketGroup是票牛定义的商品,对应一个票档下某个卖家售卖的商品,需要在创建订单时传入
  5. 每个票档只会推送一个商品,但是每次通过票档拿到的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 第一版,同步演出、库存,以及订单相关接口

results matching ""

    No results matching ""