创建订单（联动使用） - 良票开放平台 v2.0

请求参数

Query 参数

appId

string

必需

sign

string

必需

timestamp

string

必需

Body 参数application/json

seats

array [object {3}]

座位信息

必需

row

string

行

必需

col

string

列

必需

seatName

string

坐位名称 x行x列

必需

showId

string

场次信息

必需

changeSeat

string

是否支持换座

必需

原座：0，换座：1

callbackUrl

string

回调地址

必需

接收回调订单信息的接口地址（POST JSON）

outOrderNumber

string

外部订单编号回调透传

必需

自己的订单号

channel

string

出票渠道

必需

请入参3

inputLimitPrice

string

最高限价（分）

可选

单座限价，此参数可为空，【为空情况下，订单按提货价结算】\【入参情况下按实际成交价结算】

officialChannelState

string

官方渠道状态

必需

官方限价：1，官方一口价：2

officialQuotationId

string

官方询价ID

可选

官方预报价任务ID

示例

{
    "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

curl --location --request POST 'api/film/order/officialSubmitOrder?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

数据

必需

seats

array [object {3}]

座位信息列表

必需

id

integer

id

必需

orderNumber

string

订单号

必需

userId

integer

下单用户

必需

userName

string

下单人

必需

priceAll

integer

原价（总价）

必需

realPriceAll

integer

购买价（总价）

必需

limitPriceAll

integer

限价（总价）

必需

outOrderNumber

string

外部订单编号

必需

cinemaCode

string

影院专资编码

必需

cinemaName

string

影院名称

必需

cinemaId

integer

影院id

必需

filmId

integer

电影id

必需

filmName

string

电影名

必需

showId

integer

场次id

必需

showName

string

场次名称

必需

seatCount

integer

座位i数量

必需

submitTime

integer

下单时间

必需

payTime

integer

支付时间

必需

payStatus

integer

支付状态

必需

orderStatus

integer

订单状态

必需

receiveTime

integer

接单时间

必需

finishTime

integer

完成时间

必需

receiveUserId

integer

接单用户id

必需

receiveUserName

string

接单人

必需

changeSeatStatus

integer

换座状态

必需

0 不可换座 1 可换座 2 已换座

callbackUrl

string

回调地址

必需

channel

integer

出票渠道

必需

price

integer

原价

必需

realPrice

integer

卖价

必需

limitPrice

integer

限价

必需

seatType

integer

座位类型

必需

filmShowTime

integer

开场时间

必需

orderType

integer

订单类型

必需

cinemaAddress

string

影院地址

必需

roundIndex

integer

当前轮次

必需

roundBeginTime

integer

当前轮次开始时间

必需

roundEndTime

integer

当前轮次结束时间

必需

cityCode

integer

城市编码

必需

cityName

string

城市名称

必需

filmPic

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
}