开放平台
  1. 电影票接口
开放平台
  • App/H5对接流程:
  • API开放接口对接流程
  • 小程序对接流程v1.1
  • 数据推送说明
  • 基础信息
    • 获取接口访问令牌
      POST
    • 更改密码
      POST
    • 企业用户信息 v1.1
      GET
    • 获取会员token
      POST
  • 电影票接口
    • 电影票回调通知
    • 获取城市列表
      GET
    • 热映电影(pageIndex从0开始)
      GET
    • 即将上映电影
      GET
    • 获取影院列表
      GET
    • 获取影院过滤列表(获取城市影院品牌和区域信息)
      GET
    • 获取电影的影院列表
      GET
    • 获取电影详情
      GET
    • 获取影院某个电影的排片列表
      GET
    • 获取电影场次(座位)详情
      GET
    • 创建订单
      POST
    • 订单简要信息(字段较简洁,用于发起订单支付)
      GET
    • 支付订单(用户付款成功后调用)
      GET
    • 订单列表(管理)
      POST
    • 订单详情
      GET
    • 返回所有电影
      GET
    • 获取广告列表
      GET
  • 卡券接口
    • GiftCard
      • 卡券商品分类列表
      • 卡券商品列表
      • 商品详情
      • 下单(自己做产品展示,才需要下单接口)
      • 订单支付通知
      • 订单列表
      • 订单详情
      • 卡券商品按类别列表(共二级分类)
  • 点餐接口
    • 点餐回调通知
    • 城市列表
    • 平台店铺列表
    • 店铺详情,如果传了经纬度,返回距离
    • 菜单
    • 商品详情(不同品牌商品详情会有所不同)
    • 创建订单(不同品牌的商品详情下单的参数会有所不同)
    • 订单支付通知(用户付款成功后调用)
    • 订单列表
    • 订单详情
    • 订单上传文件列表
  1. 电影票接口

电影票回调通知

回调地址在群通知我方技术人员在后台配置
推送方式为POST
统一的数据格式:{type:0电影订单 1生活卡券订单 2返利商品订单 3外卖订单 4吃喝玩乐订单 5点餐订单,data:{对应的业务数据}}
有重发机制,如果接收推送数据的接口返回的http状态不是200,则会按一定的间隔时间重发3次,如果都没有成功,则记录为失败,等对接方通知我们接口正常了以后可以重新推送
金额单位为元,保留两位小数点
订单成本(结算)价=用户总价-佣金(totalPrice-totalCommission)
totalPrice = 订单详情接口返回的字段:totalUserPrice
电影票订单推送
当电影票的订单状态发生变化时,系统会向 pushUrl(回调推送地址)推送订单状态和订单信息。具体的推送速度可能会因系统当前的购票人数而有所不同,若购票人数较多,推送可能会有所延迟。
参数说明
state:电影状态枚举:0待支付,1已支付,4出票成功,7出票失败(退款),8超时未付(“订单创建10分钟后如果未支付就视为超时”取消)
注:不是订单状态转变就推送回调消息,而是当订单出票成功、订单出票失败(退款),还有取票码更新(变更)才会推送回调消息。
{
    "type": 0,
    "data": {
        "state": "4出票成功,7出票失败(退款)",
        "para": "自定义数据,第三方订单号,订单创建时生成的自定义订单号",
        "id": "202009070619797683",
        "movieName": "电影名称",
        "movieStartTime": "2020-09-08 12:50:00",
        "movieEndTime": "2020-09-08 14:45:00",
        "cinemaName": "大地影院(忠信广场店)",
         "seatNames":"座位",
        "totalPrice": "55(客户总价)",
        "totalCommission": "4.4(总佣金)",
        "refundAmount": "退款金额,当无法出票或者影院退票的时候有值,可能是部分退或全部退",
        "ticketCode": "电子码,多个用逗号','隔开",
        "ticketCodeText": "电子码文本",
        "totalOriginPrice":"60(原票价总价)",
        "createTime":"2020-09-08 10:20:00(订单创建时间)",
        "updateTime":"2020-09-08 10:20:00 (订单最后更新时间)"
    }
}
上一页
获取会员token
下一页
获取城市列表
Built with