良票开放平台 v2.0
  1. 业务侧-影票代订-api
良票开放平台 v2.0
  • 业务端
    • 第三方业务服务商-对接必读
    • 业务侧-影票代订-api
      • 获取城市列表
        POST
      • 获取区县列表
        POST
      • 获取院线列表
        POST
      • 获取在映影片列表
        POST
      • 获取影片详情
        POST
      • 获取影院列表
        POST
      • 获取影院详情
        POST
      • 获取影院场次信息
        POST
      • 获取座位信息(已弃用)
        POST
      • 获取座位信息V2
        POST
      • 创建订单
        POST
      • 支付提交订单
        POST
    • 影票-询价提单场景api
      • 获取预估/一口价-出票价格
      • 创建订单(联动使用)
  1. 业务侧-影票代订-api

创建订单

POST
/api/film/order/submitOrder
最后修改时间:2025-03-26 02:53:29

请求参数

Query 参数
appId
string 
必需
sign
string 
必需
timestamp
string 
必需
Body 参数application/json
seats
array [object {3}] 
必需
row
string 
必需
col
string 
必需
seatName
string 
必需
showId
string 
场次信息
必需
changeSeat
string 
是否支持换座
必需
callbackUrl
string 
回调地址
必需
outOrderNumber
string 
外部订单编号回调透传
必需
channel
string 
出票渠道
必需
请入参3
inputLimitPrice
string 
最高限价(分)
可选
单座限价,此参数可为空,【为空情况下,订单按提货价结算】\【入参情况下按实际成交价结算】
matchChannel
string 
首选渠道
必需
1=竞标池(不可用);2=GM渠道1(不可用);3=麻花-支持限价;4=GM渠道2(不可用);5=原芒果(不可用);6=哈哈-不支持限价(不可用);7=守兔-支持限价;8=星驰(不可用);9=哈哈85折快票(不可用);10=影划算-支持限价;11=守兔一口价;66=芒果一口价;88=芒果-支持限价
slaveMatchChannel
string 
备选渠道
必需
0=不使用备选;1=竞标池(不可用);2=GM渠道1(不可用);3=麻花-支持限价;4=GM渠道2(不可用);5=原芒果(不可用);6=哈哈-不支持限价(不可用);7=守兔-支持限价;8=星驰(不可用);9=哈哈85折快票(不可用);10=影划算-支持限价;11=守兔一口价;66=芒果一口价;88=芒果-支持限价
示例
{
  "showId": "1167046042641293321L",
  "changeSeat": "1",
  "callbackUrl": "",
  "outOrderNumber": "123456",
  "channel": "2",
  "inputLimitPrice": "50000",
  "matchChannel": "3",
  "slaveMatchChannel": "5",
  "seats": [
    {
      "row": "7",
      "col": "3",
      "seatName": "7排3号"
    },
    {
      "row": "7",
      "col": "2",
      "seatName": "7排2号"
    }
  ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/film/order/submitOrder?appId=&sign=&timestamp=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "showId": "1167046042641293321L",
    "changeSeat": "1",
    "callbackUrl": "",
    "outOrderNumber": "123456",
    "channel": "2",
    "inputLimitPrice":"50000",
    "matchChannel": "3",
    "slaveMatchChannel": "5",
    "seats": [
        {
            "row": "7",
            "col": "3",
            "seatName": "7排3号"
        },
        {
            "row": "7",
            "col": "2",
            "seatName": "7排2号"
        }
    ]
}'

返回响应

🟢200成功
application/json
Body
state
integer 
状态
必需
message
string 
消息
必需
data
object 
数据
必需
callbackUrl
string 
回调地址
必需
changeSeatStatus
integer 
换座状态
必需
0 不可换座 1 可换座 2 已换座
channel
integer 
出票渠道
必需
cinemaAddress
string 
影院地址
必需
cinemaCode
string 
影院专资编码
必需
cinemaId
integer 
影院id
必需
cinemaName
string 
影院名称
必需
cityCode
integer 
城市编码
必需
cityName
string 
城市名称
必需
filmId
integer 
电影id
必需
filmName
string 
电影名
必需
filmPic
string 
电影图片
必需
filmShowTime
integer 
开场时间
必需
finishTime
integer 
完成时间
必需
id
integer 
id
必需
limitPrice
integer 
限价
必需
limitPriceAll
integer 
限价(总价)
必需
orderNumber
string 
订单号
必需
orderStatus
integer 
订单状态
必需
orderType
integer 
订单类型
必需
outOrderNumber
string 
外部订单编号
必需
payStatus
integer 
支付状态
必需
payTime
integer 
支付时间
必需
price
integer 
原价
必需
priceAll
integer 
原价(总价)
必需
realPrice
integer 
卖价
必需
realPriceAll
integer 
购买价(总价)
必需
receiveTime
integer 
接单时间
必需
receiveUserId
integer 
接单用户id
必需
receiveUserName
string 
接单人
必需
roundBeginTime
integer 
当前轮次开始时间
必需
roundEndTime
integer 
当前轮次结束时间
必需
roundIndex
integer 
当前轮次
必需
seatCount
integer 
座位i数量
必需
seatType
integer 
座位类型
必需
seats
array [object {3}] 
座位信息列表
必需
showId
integer 
场次id
必需
showName
string 
场次名称
必需
submitTime
integer 
下单时间
必需
userId
integer 
下单用户
必需
userName
string 
下单人
必需
result
boolean 
必需
token
null 
必需
示例
{
  "state": 200,
  "message": "",
  "data": {
    "callbackUrl": "",
    "changeSeatStatus": 1,
    "channel": 2,
    "cinemaAddress": "晋江市安海镇上悦城3楼",
    "cinemaCode": "35050321",
    "cinemaId": 1166372010777931800,
    "cinemaName": "横店电影城安海上悦城店(全激光影厅)",
    "cityCode": 350500,
    "cityName": "泉州市",
    "filmId": 1166400785188339700,
    "filmName": "拯救嫌疑人",
    "filmPic": "https://gw.alicdn.com/i3/O1CN011KgNi71g4oP2sXZV2_!!6000000004089-0-alipicbeacon.jpg_480x480Q30s150.jpg",
    "filmShowTime": 1699013700000,
    "finishTime": 0,
    "id": 1169667879470702600,
    "limitPrice": 4395,
    "limitPriceAll": 8790,
    "orderNumber": "2023110200023",
    "orderStatus": 1,
    "orderType": 2,
    "outOrderNumber": "aa",
    "payStatus": 0,
    "payTime": 0,
    "price": 4400,
    "priceAll": 8800,
    "realPrice": 4390,
    "realPriceAll": 8780,
    "receiveTime": 0,
    "receiveUserId": 0,
    "receiveUserName": "",
    "roundBeginTime": 0,
    "roundEndTime": 0,
    "roundIndex": 0,
    "seatCount": 2,
    "seatType": 1,
    "seats": [
      {
        "col": "3",
        "row": "7",
        "seatName": "7排3号"
      },
      {
        "col": "2",
        "row": "7",
        "seatName": "7排2号"
      }
    ],
    "showId": 1167046042641293300,
    "showName": "1号电影党课主题厅(3D影片建议您自备眼镜)",
    "submitTime": 1698912153844,
    "userId": 1715213770677637000,
    "userName": "13931933190"
  },
  "result": true,
  "token": null
}
修改于 2025-03-26 02:53:29
上一页
获取座位信息V2
下一页
支付提交订单
Built with