开放平台
  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
/api/movie/create_order2
Movie
创建订单,支持下单即支付、下单后调用支付接口两种模式(建议使用下单后调用支付接口模式)。
注:如果一个订单有不同区域的两个座位,票的价格可能一高一低,因为我们处理跨区座位订单的规则是使用(最高座位价*座位数量)来计算用户总价。
一般我们不建议对接方提交跨区座位订单,这种单出票失败的几率会比较大,所以建议一个订单要购买多个座位的情况,要让订单中的座位都在一个区域,
不同的区域请分开下单。

请求参数

Body 参数application/json
渠道下单
appId
string 
必需
我方分配的appId
orderId
string  | null 
可选
第三方订单号,这是贵公司为订单创建时生成的自定义订单号,用于在与贵公司系统交互时唯一标识该订单。
cinemaCode
string 
影院编码
必需
movieCode
string  | null 
影片编码
可选
cityName
string  | null 
城市名称
可选
cinemaName
string  | null 
影院名称
可选
hallName
string 
影厅名称
必需
movieName
string  | null 
影片名称
可选
postImageUrl
string  | null 
影片海报图
可选
seatNames
string 
必需
座位名称(多个用逗号分隔)
switchSeat
boolean 
是否可调座
必需
cinemaAddress
string  | null 
影院地址
可选
sessionBeginTime
string <date-time>
开场时间
必需
sessionEndTime
string <date-time> | null 
结束时间
可选
movieVersion
string  | null 
可选
影票类型(2D/ 3D)
userMobile
string  | null 
用户手机号
可选
originPrice
number <double>
必需
原票价单价(传入所选座位原价originPrice的最高值)
orderPayMode
enum<integer> <int32>
可选
订单支付模式

1:PayLater,先下单再支付(在下单时必须指定支付方式状态为固定值 “1”。请严格按照此要求填写,若填写除 “1” 以外的其他数字,由此产生的一切后果需自行承担);
枚举值:
1
fastTicket
boolean 
可选
是否为快速票(传true为快速票,传false或不传为特惠票)注:特惠票下单需要在电影开场前45分钟,如果小于45分钟,用户只能下快速票。
test
boolean 
可选
是否是测试订单(测试订单不会真实出票,请联系测试人员模拟出票、退款等)
pushUrl
string 
可选
回调推送地址(如果有值,订单相关回调我方将推送到这个地址)
示例
{
  "appId": "string",
  "orderId": "string",
  "cinemaCode": "string",
  "movieCode": "string",
  "cityName": "string",
  "cinemaName": "string",
  "hallName": "string",
  "movieName": "string",
  "postImageUrl": "string",
  "seatNames": "string",
  "switchSeat": true,
  "cinemaAddress": "string",
  "sessionBeginTime": "2019-08-24T14:15:22Z",
  "sessionEndTime": "2019-08-24T14:15:22Z",
  "movieVersion": "string",
  "userMobile": "string",
  "originPrice": 0,
  "orderPayMode": 1,
  "fastTicket": true,
  "test": true,
  "pushUrl": "string"
}

返回响应

🟢200Success
application/json
code=0为成功,非0为失败,具体错误原因参看message文本描述。
code=96代表对接方预存余额不足,请尽快联系我方对接充值。系统会显示提示信息message=“系统升级中,请稍后再试”,此提示用于隐藏具体原因,以免用户直接看到余额不足的状态;请尽快联系我方对接人员充值,以确保服务恢复正常。
Body
code
integer <int32>
code
可选
message
string  | null 
message
可选
data
object (ChannelTicketOrderResult) 
可选
orderId
string  | null 
平台订单号
可选
示例
{
  "code": 0,
  "message": "string",
  "data": {
    "orderId": "string"
  }
}
上一页
获取电影场次(座位)详情
下一页
订单简要信息(字段较简洁,用于发起订单支付)
Built with