开放平台
  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. 电影票接口

获取电影场次(座位)详情

GET
/api/movie/session
Movie

请求参数

Query 参数
sessionId
string 
必需
场次id((影院系统某些情况下会变更场次ID,建议实时获取,不要缓存))
cinemaId
string 
必需
影院id(cinemaCode值或cinemaId值皆可传入,建议传入cinemaCode值)
movieId
string 
必需
电影id(movieCode值或movieId值皆可传入,建议传入movieCode值)
sid
string 
可选
来自前一个接口的sourceId

返回响应

🟢200Success
application/json
Body
code
integer <int32>
code
可选
message
string  | null 
message
可选
data
object (TicketSession) 
场次
可选
seatSection
object (TicketSeatSection) 
座位
可选
sessionId
string  | null 
可选
场次ID(影院系统某些情况下会变更场次ID,建议实时获取,不要缓存)
>= 0 字符<= 20 字符
showTime
string <date-time>
开始时间
可选
>= 0 字符<= 10 字符
language
string  | null 
语言
可选
reservedMin
integer <int32>
可选
最晚预定时间,离开场几分钟
sourcePrice
number <double>
票商价(已弃用)
可选
originPrice
number <double>
市场原价
可选
sellPrice
number <double>
特惠票价
可选
fastPrice
number <double>
快速票价
可选
hall
string  | null 
影厅名
可选
ticketStatus
string  | null 
售票情况
可选
version
string  | null 
可选
影片类型 2D/3d
endTime
string <date-time>
影片结束时间
可选
cinemaName
string  | null 
影院名称
可选
cinemaId
string  | null 
影院Id
可选
cinemaCode
string  | null 
影院编码
可选
movieName
string  | null 
电影名称
可选
movieId
string  | null 
电影ID
可选
movieCode
string  | null 
电影编码
可选
cityName
string  | null 
城市名称
可选
postImageUrl
string  | null 
电影海报地址
可选
cinemaAddress
string  | null 
影院地址
可选
priceRuleId
string <uuid> | null 
价格规则id
可选
rtSeats
object (RtSeats) 
可选
needRealName
integer <int32>
可选
areaPrice
string  | null 
可选
忽略此字段,分区价查看areaPriceList
areaPriceList
array[object (AreaPrcie) {5}]  | null 
座位分区价格列表
可选
sourceId
string  | null 
票源id
可选
closeFastTicket
boolean 
关闭快速出票
可选
示例
{
  "code": 0,
  "message": "string",
  "data": {
    "seatSection": {
      "rowCount": 0,
      "columnCount": 0,
      "seatRows": [
        {
          "rowsId": "string",
          "rowsNum": "string",
          "columns": [
            {
              "colId": "string",
              "colNum": "string",
              "seatName": "string",
              "originSeatID": "string",
              "state": 0,
              "type": 0,
              "areaId": "string"
            }
          ]
        }
      ]
    },
    "sessionId": "string",
    "showTime": "2019-08-24T14:15:22Z",
    "language": "string",
    "reservedMin": 0,
    "sourcePrice": 0,
    "originPrice": 0,
    "sellPrice": 0,
    "fastPrice": 0,
    "hall": "string",
    "ticketStatus": "string",
    "version": "string",
    "endTime": "2019-08-24T14:15:22Z",
    "cinemaName": "string",
    "cinemaId": "string",
    "cinemaCode": "string",
    "movieName": "string",
    "movieId": "string",
    "movieCode": "string",
    "cityName": "string",
    "postImageUrl": "string",
    "cinemaAddress": "string",
    "priceRuleId": "d46a626c-f2f2-4dea-a792-32cbc3f4487f",
    "rtSeats": {
      "r5": [
        {
          "columnId": "string",
          "rowId": "string",
          "rowNum": "string"
        }
      ],
      "r4": [
        {
          "columnId": "string",
          "rowId": "string",
          "rowNum": "string"
        }
      ],
      "r1": [
        {
          "columnId": "string",
          "rowId": "string",
          "rowNum": "string"
        }
      ],
      "r6": [
        {
          "columnId": "string",
          "rowId": "string",
          "rowNum": "string"
        }
      ],
      "r3": [
        {
          "columnId": "string",
          "rowId": "string",
          "rowNum": "string"
        }
      ],
      "r2": [
        {
          "columnId": "string",
          "rowId": "string",
          "rowNum": "string"
        }
      ]
    },
    "needRealName": 0,
    "areaPrice": "string",
    "areaPriceList": [
      {
        "areaId": "string",
        "price": 0,
        "fastPrice": 0,
        "originPrice": 0,
        "sourcePrice": 0
      }
    ],
    "sourceId": "string",
    "closeFastTicket": true
  }
}
上一页
获取影院某个电影的排片列表
下一页
创建订单
Built with