芒果API接口
  1. 接口列表
芒果API接口
  • 对接必读
  • 回调通知
  • API兼容说明(仅旧版本查看)
  • 接口列表
    • 全国所有城市
      POST
    • 城市的行政区/县
      POST
    • 热映电影&待上映电影
      POST
    • 搜索影片或影院
      POST
    • 影片信息&某城市下的影片排期
      POST
    • 影院列表
      POST
    • 查询某影院所属院线
      POST
    • 影片近期有排期的影院
      POST
    • 影院信息&影院排期的电影数据
      POST
    • 影院的电影场次数据
      POST
    • 影院的电影场次座位数据
      POST
    • 锁座下单
      POST
    • 释放座位
      POST
    • 确认下单
      POST
    • 查询订单详情
      POST
    • 查询账户余额
      POST
    • 获取H5+Token链接
      POST
    • 批量拉取影院数据
      POST
    • 批量拉取场次数据
      POST
  • 其他
    • APP/微信小程序嵌入H5
  1. 接口列表

锁座下单

POST
/api/622c5d0a77467

对接方务必重视以下几点,若因此影响客户体验后果自负!#

1、seat_data字段说明:#


①SeatCode必传!
②座位存在分区时area_id参数必传,不传会导致订单溢价并退款,影响用户体验
json格式:
[{"area_id":"存在分区座位时必传该字段","SeatCode":"座位ID","lovestatus":"0为非情侣座 1为情侣座左 2为情侣座右","seatNo":"座位名称"},{"SeatCode":"MjQ3MzZAX0AxMjQ4NjRAX0AxNjEwMzYyMjAwQF9AMUBfQDYxQF9AMDMwMDAwMDMwMTIwMDYwMUBfQDYxQF9AMEBfQDXmjpI35bqn","lovestatus":0,"seatNo":"5排6座"}]

2、锁座下单后时效为【10分钟】,需要在时效内调用【确认下单】接口, 超过【10分钟】未确认下单判定为支付超时#


可通过【查询订单详情】接口查看订单状态和支付剩余时间。为了保障用户体验,建议用户在支付前调用【查询订单详情】接口,若为“支付超时”状态时应当及时拦截用户付款行为

3、订单溢价:#


当code返回10040时表示订单溢价,对接方可延迟2-3分钟后重新拉取该影院场次。
对接方可在调用锁座下单接口时将我方锁座价格与对接方付款价格对比,若不一致则需要重新拉取本影院场次,以免出现因场次同步延迟导致的价格问题

4、情侣座说明:#


①判断为情侣座时,计算情侣座位数是否为双数,如果为单数返回提醒:情侣座必须成对购买
②判断为情侣座时,根据lovestatus字段判断是否为相邻座位,如果不是相邻返回提醒:情侣座必须相邻购买

5、关于隔空选座问题#


当一排连续的有效座位大于五个以上时,对当前选择座位所在的一排座位检测,只要所选座位左右两边任意一边存在一个未选择的有效座位,就不可以选择,遇到非有效座位(过道、空、墙等)时停止

请求参数

Body 参数application/json
tel
string 
订票手机号
必需
room_id
string 
场次ID
必需
seat_data
string 
座位数据
必需
座位分区时需要加area_id参数,json格式:[{"area_id":"存在分区座位时必传该字段","SeatCode":"座位ID","lovestatus":"是否情侣座位 0否 1是 2 相邻座位","seatNo":"座位名称"},{"SeatCode":"MjQ3MzZAX0AxMjQ4NjRAX0AxNjEwMzYyMjAwQF9AMUBfQDYxQF9AMDMwMDAwMDMwMTIwMDYwMUBfQDYxQF9AMEBfQDXmjpI35bqn","lovestatus":0,"seatNo":"5排6座"}]
auto_check_seat
string 
是否允许自动换座
可选
0 不允许/1 允许,默认为0
attach
string 
附加参数
可选
限制300字节内
cinema_id
integer 
(可不传)影院ID
可选
禁止从场次列表接口中读取该字段
film_id
integer 
(可不传)影片ID
可选
禁止从场次列表接口中读取该字段(film_id和film_code二选一,同时存在优先取film_code)
film_code
string 
(可不传)影片专资编码
可选
专资办影片统一编码11位(film_id和film_code二选一,同时存在优先取film_code)
supplier_max_price
string 
限价金额
可选
示例
{
    "agent_id": "101097",
    "app_id": "2931",
    "tel": "13444046807",
    "room_id": "a10560ea0f954071270b233c8fca145a-5724-0",
    "seat_data":"[{\"columnNo\":\"1\",\"rowNo\":\"4\",\"lovestatus\":0,\"areaId\":\"8369\",\"price\":36.9,\"seatId\":\"000000040727-4-1\",\"seatNo\":\"4排1座\",\"SeatCode\":\"000000040727-4-1\",\"status\":\"N\"}]",
    "signid": "ca703823afe53a4df1e3726be0bd88ef"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-service.mgmovie.net/api/622c5d0a77467' \
--header 'Content-Type: application/json' \
--data-raw '{
    "agent_id": "101097",
    "app_id": "2931",
    "tel": "13444046807",
    "room_id": "a10560ea0f954071270b233c8fca145a-5724-0",
    "seat_data":"[{\"columnNo\":\"1\",\"rowNo\":\"4\",\"lovestatus\":0,\"areaId\":\"8369\",\"price\":36.9,\"seatId\":\"000000040727-4-1\",\"seatNo\":\"4排1座\",\"SeatCode\":\"000000040727-4-1\",\"status\":\"N\"}]",
    "signid": "ca703823afe53a4df1e3726be0bd88ef"
}'

返回响应

🟢200成功
application/json
Body
success
boolean 
必需
code
integer 
必需
message
string 
必需
data
object 
必需
city
string 
影院所在城市
必需
maoyan_price
string 
网售价(原价/猫眼价)
必需
final_price
string 
优惠价格(用户付款价/结算价)
必需
rule_price
string 
快速通道价格
必需
show_end_time
string 
电影结束时间戳
必需
fast_if
boolean 
是否支持快速出票通道
必需
true 支持 / false 不支持
order_info
object 
订单信息
必需
示例
{
    "success": true,
    "code": 1,
    "message": "操作成功",
    "data": {
        "city": "影院所在城市",
        "maoyan_price": "网售价(原价)",
        "final_price": "优惠价格(用户付款价)",
        "rule_price": "快速通道价格",
        "show_end_time": "电影结束时间戳",
        "fast_if": "是否支持快速出票",
        "order_info": {
            "order_number": "订单编号",
            "created_at": "订单创建时间"
        }
    }
}
上一页
影院的电影场次座位数据
下一页
释放座位
Built with