开放平台
  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