- 接入说明
- 机票分销 内容聚合直连API
- 分销订单管理API
- 航变API
- 缓存刷新API
- 辅营订单管理API
预定接口（Order）即将废弃
Deprecated
POST
/api/flight/order
接口规范#
订单接口的数据传输需使用 AES 进行加密，然后以 base64 格式进行编码。
原始密钥：
abcdefghigklmnopqrstuvwxyz0123456789加密后：
8Z3dZzqn05FmiuBLowExK0CAbs4TY2GorC2dDPVlsn/tP+VuJGePqIMv1uSaVErr:::
状态码#
| 状态码 | 解释 | 备注 |
|---|---|---|
| 0 | 成功 | |
| 1 | 所有座位已售罄 | |
| 2 | 客舱座位不足 | |
| 3 | 因其他原因失败 | |
| 5 | 项目异常 | |
| 6 | 预订失败 | 预订过程中价格变动 |
| 7 | PNR 为空 | 上游预订未成功 |
| 8 | 与航班信息不符 | 在定价阶段无匹配航班结果 |
| 9 | 所指定票价未找到 | 在定价阶段无匹配航班结果 |
| 10 | 航空公司或 GDS 超时 | |
| 101 | 上游返回的重复预订信息 | |
| 200 | 航空公司或 GDS 服务异常 | 服务异常 |
| 211 | 乘客信息请求错误 | 例如，儿童乘客预订了成人机票 |
| 212 | 名称格式错误 | |
| 213 | 名称长度错误 | |
| 214 | 乘客人数错误 | 不符合成人 1-9 人、儿童 0-8 人、婴儿 0 人的规定 |
| 215 | 运营或验证航空公司错误 | |
| 217 | 行李预订失败 |
Request
Body Params application/json
Example
{
"contact": {
"email": "cs.flightnotice@oneworldtrip.cn",
"mobile": "86 121313313",
"name": "oneworldtrip"
},
"cutOffTime": 19500,
"modifyTktNumType": 1,
"orderNumber": 917049394071227300,
"passengerAuxes": [
{
"passengerNumber": 1,
"segment": {
"carrier": "VJ",
"flightNumber": "VJ1170",
"depAirport": "SGN",
"arrAirport": "HAN",
"depTime": "202505232335",
"arrTime": "202505240145",
"cabinClass": "Y",
"cabin": "W"
},
"productItems": [
{
"productCode": "SEATPP-1",
"productName": "选座",
"productType": "5",
"price": 14.32,
"currency": "USD",
"seatCode": "4-B"
},
{
"productCode": "BAG20kg",
"productName": "Bag 20kgs",
"productType": "0",
"saleType": "1",
"price": 18.42,
"currency": "USD",
"baggage": {
"pc": 1,
"weight": 20,
"isAllWeight": true
}
}
],
"bookNum": 1
},
{
"passengerNumber": 2,
"segment": {
"carrier": "VJ",
"flightNumber": "VJ1170",
"depAirport": "SGN",
"arrAirport": "HAN",
"depTime": "202505232335",
"arrTime": "202505240145",
"cabinClass": "Y",
"cabin": "W"
},
"productItems": [
{
"productCode": "SEATPP-1",
"productName": "选座",
"productType": "5",
"price": 14.32,
"currency": "USD",
"seatCode": "4-D"
},
{
"productCode": "BAG20kg",
"productName": "Bag 20kgs",
"productType": "0",
"saleType": "1",
"price": 18.42,
"currency": "USD",
"baggage": {
"pc": 1,
"weight": 20,
"isAllWeight": true
}
}
],
"bookNum": 1
}
],
"passengers": [
{
"birthday": "20030323",
"docExpiredAt": "20270331",
"docNumber": "E16662247",
"docType": "PP",
"gender": "M",
"issueCountry": "CN",
"name": "YI/JOVAN",
"nationality": "CN",
"passengerType": 0
},
{
"birthday": "20150323",
"docExpiredAt": "20270331",
"docNumber": "G76437837",
"docType": "PP",
"gender": "F",
"issueCountry": "CN",
"name": "GUO/TOM",
"nationality": "CN",
"passengerType": 1
}
],
"referenceId": "214894499318799139",
"routing": {
"data": "eyJzZWFyY2hHdWlkIjoiM2VkMGJhNTMtZjU3Yi00YTZjLWIzODItYzRhZjhlNDgxMzc4Iiwib2ZmZXJDb2RlIjoiSDRzSUFBQUFBQUFFQUQyTVBRcUFNQXhHcjZJVTNBcEpTa1F6RlVFSHUzb0FmeENIdXJrV3oyNWJzSHpUZTd4a3RCZ0hjYk5iM3NHNWw0Q01KdEJJYThLa3N6SVlsZFZvVmEzVW4xVFlDM0FvU0NTR3czSDVzSHVmczN4V1FTY0VvU0NpTUtja3BhcHBwdTFfenZoWDJwNkFSZUFEUEFUQ2dKY0FBQUEtYiJ9",
"fromSegments": [
{
"marketingCarrier": "VJ",
"depAirport": "SGN",
"depTime": "202505232335",
"arrAirport": "HAN",
"arrTime": "202505240145",
"seatClass": "W",
"flightNumber": "VJ1170",
"codeShare": false,
"aircraftCode": "321",
"operatingCarrier": "VJ",
"operatingFlightNo": "VJ1170"
}
],
"retSegments": []
},
"sessionId": "210455864884402699",
"tripType": "1",
"vendorCode": "IST-PETOUR",
"agentCode": "123"
}Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://58.250.183.7:31011/api/flight/order' \
--header 'Content-Type: application/json' \
--data-raw '{
"contact": {
"email": "cs.flightnotice@oneworldtrip.cn",
"mobile": "86 121313313",
"name": "oneworldtrip"
},
"cutOffTime": 19500,
"modifyTktNumType": 1,
"orderNumber": 917049394071227300,
"passengerAuxes": [
{
"passengerNumber": 1,
"segment": {
"carrier": "VJ",
"flightNumber": "VJ1170",
"depAirport": "SGN",
"arrAirport": "HAN",
"depTime": "202505232335",
"arrTime": "202505240145",
"cabinClass": "Y",
"cabin": "W"
},
"productItems": [
{
"productCode": "SEATPP-1",
"productName": "选座",
"productType": "5",
"price": 14.32,
"currency": "USD",
"seatCode": "4-B"
},
{
"productCode": "BAG20kg",
"productName": "Bag 20kgs",
"productType": "0",
"saleType": "1",
"price": 18.42,
"currency": "USD",
"baggage": {
"pc": 1,
"weight": 20,
"isAllWeight": true
}
}
],
"bookNum": 1
},
{
"passengerNumber": 2,
"segment": {
"carrier": "VJ",
"flightNumber": "VJ1170",
"depAirport": "SGN",
"arrAirport": "HAN",
"depTime": "202505232335",
"arrTime": "202505240145",
"cabinClass": "Y",
"cabin": "W"
},
"productItems": [
{
"productCode": "SEATPP-1",
"productName": "选座",
"productType": "5",
"price": 14.32,
"currency": "USD",
"seatCode": "4-D"
},
{
"productCode": "BAG20kg",
"productName": "Bag 20kgs",
"productType": "0",
"saleType": "1",
"price": 18.42,
"currency": "USD",
"baggage": {
"pc": 1,
"weight": 20,
"isAllWeight": true
}
}
],
"bookNum": 1
}
],
"passengers": [
{
"birthday": "20030323",
"docExpiredAt": "20270331",
"docNumber": "E16662247",
"docType": "PP",
"gender": "M",
"issueCountry": "CN",
"name": "YI/JOVAN",
"nationality": "CN",
"passengerType": 0
},
{
"birthday": "20150323",
"docExpiredAt": "20270331",
"docNumber": "G76437837",
"docType": "PP",
"gender": "F",
"issueCountry": "CN",
"name": "GUO/TOM",
"nationality": "CN",
"passengerType": 1
}
],
"referenceId": "214894499318799139",
"routing": {
"data": "eyJzZWFyY2hHdWlkIjoiM2VkMGJhNTMtZjU3Yi00YTZjLWIzODItYzRhZjhlNDgxMzc4Iiwib2ZmZXJDb2RlIjoiSDRzSUFBQUFBQUFFQUQyTVBRcUFNQXhHcjZJVTNBcEpTa1F6RlVFSHUzb0FmeENIdXJrV3oyNWJzSHpUZTd4a3RCZ0hjYk5iM3NHNWw0Q01KdEJJYThLa3N6SVlsZFZvVmEzVW4xVFlDM0FvU0NTR3czSDVzSHVmczN4V1FTY0VvU0NpTUtja3BhcHBwdTFfenZoWDJwNkFSZUFEUEFUQ2dKY0FBQUEtYiJ9",
"fromSegments": [
{
"marketingCarrier": "VJ",
"depAirport": "SGN",
"depTime": "202505232335",
"arrAirport": "HAN",
"arrTime": "202505240145",
"seatClass": "W",
"flightNumber": "VJ1170",
"codeShare": false,
"aircraftCode": "321",
"operatingCarrier": "VJ",
"operatingFlightNo": "VJ1170"
}
],
"retSegments": []
},
"sessionId": "210455864884402699",
"tripType": "1",
"vendorCode": "IST-PETOUR",
"agentCode": "123"
}'Responses
🟢200成功
application/json
Body
Example
{
"extraInfo": {},
"maxSeats": 9,
"msg": "Success",
"vendorOrderNumber": "30142",
"pnr": "UQQOSY",
"routing": {
"changeInfoList": [
{
"passengerType": 0,
"changeType": 1,
"conditionList": [
{
"start": "96",
"end": "36",
"unit": "h",
"changeable": true,
"changeFee": "1000",
"currency": "INR"
},
{
"start": "36",
"end": "0",
"unit": "h",
"changeable": true,
"changeFee": "8000",
"currency": "INR"
}
]
},
{
"passengerType": 0,
"changeType": 0,
"conditionList": [
{
"start": "96",
"end": "36",
"unit": "h",
"changeable": true,
"changeFee": "2000",
"currency": "INR"
},
{
"start": "58",
"end": "28",
"unit": "h",
"changeable": true,
"changeFee": "9000",
"currency": "INR"
}
]
},
{
"passengerType": 1,
"changeType": 1,
"conditionList": [
{
"start": "96",
"end": "36",
"unit": "h",
"changeable": false,
"changeFee": "1000",
"currency": "INR"
}
]
}
],
"currency": "USD",
"data": "eyJzZWFyY2hHdWlkIjoiM2VkMGJhNTMtZjU3Yi00YTZjLWIzODItYzRhZjhlNDgxMzc4Iiwib2ZmZXJDb2RlIjoiSDRzSUFBQUFBQUFFQUQyTVBRcUFNQXhHcjZJVTNBcEpTa1F6RlVFSHUzb0FmeENIdXJrV3oyNWJzSHpUZTd4a3RCZ0hjYk5iM3NHNWw0Q01KdEJJYThLa3N6SVlsZFZvVmEzVW4xVFlDM0FvU0NTR3czSDVzSHVmczN4V1FTY0VvU0NpTUtja3BhcHBwdTFfenZoWDJwNkFSZUFEUEFUQ2dKY0FBQUEtYiJ9",
"fareBasis": "",
"freeBaggageList": [
{
"baggagePiece": 1,
"baggageWeight": 20,
"flightSeq": 1,
"passengerType": 0,
"travelDirection": 1,
"carryOnPiece": 0,
"carryOnWeight": 10,
"carryOnSize": [
50,
30,
20
]
},
{
"baggagePiece": 1,
"baggageWeight": 20,
"flightSeq": 1,
"passengerType": 1,
"travelDirection": 1
},
{
"baggagePiece": 2,
"baggageWeight": 30,
"flightSeq": 2,
"passengerType": 0,
"travelDirection": 1,
"carryOnPiece": 1,
"carryOnWeight": null,
"carryOnSize": [
50,
30,
40
]
},
{
"baggagePiece": 1,
"baggageWeight": 15,
"flightSeq": 2,
"passengerType": 1,
"travelDirection": 1
}
],
"fromSegments": [
{
"aircraftCode": "798",
"arrAirport": "KUL",
"arrTerminal": "1",
"arrTime": "202403162230",
"codeShare": false,
"depAirport": "CGK",
"depTerminal": "2",
"depTime": "202403161925",
"flightNumber": 810,
"flightRefNum": 1,
"marketingCarrier": "KL",
"operatingCarrier": "KL",
"operatingFlightNumber": 121,
"rbd": "X",
"cabinClass": "Y",
"travelDirection": 1,
"stopAirport": "",
"duration": "210"
},
{
"aircraftCode": "qaw",
"arrAirport": "DMK",
"arrTerminal": "q",
"arrTime": "202403171130",
"codeShare": true,
"depAirport": "KUL",
"depTerminal": "w",
"depTime": "202403171025",
"flightNumber": 312,
"flightRefNum": 2,
"marketingCarrier": "FD",
"operatingCarrier": "FD",
"operatingFlightNumber": 110,
"rbd": "X",
"cabinClass": "Y",
"travelDirection": 2,
"stopAirport": "",
"duration": "215"
}
],
"priceList": [
{
"passengerType": 0,
"fare": 35.46,
"tax": 23.5
},
{
"passengerType": 1,
"fare": 26.12,
"tax": 23.76
}
],
"productType": "PRV",
"refundInfoList": [
{
"passengerType": 0,
"refundType": 0,
"conditionList": [
{
"start": "96",
"end": "32",
"unit": "h",
"refundable": true,
"refundFee": "10",
"currency": "INR"
}
]
},
{
"passengerType": 1,
"refundType": 0,
"conditionList": [
{
"start": "96",
"end": "32",
"unit": "h",
"refundable": false,
"refundFee": "10.00",
"currency": "INR"
}
]
}
],
"retSegments": [],
"validatingCarrier": "QZ"
},
"orderContact": {
"name": "dong/will",
"email": "10455@qq.com",
"mobile": 1823266284
},
"passengerSeats": [
{
"passengerName": "YI/JOVAN",
"paySeats": [
{
"segments": [
{
"flightNumber": 436,
"marketingCarrier": "QZ",
"depAirport": "CGK",
"arrAirport": "BKK",
"depTime": "202402291905",
"rbd": "Y"
},
{
"arrAirport": "CGK",
"depAirport": "BKK",
"depTime": "202403150820",
"flightNumber": 4330,
"marketingCarrier": "QZ",
"rbd": "Y"
}
],
"seatPrices": [
{
"ancillaryKey": "58e62e44dea28e562ba89f9757db8bf6",
"selectedSeatNo": "10E",
"paySeatCurrency": "USD",
"paySeatPrice": 16,
"desc": "windows"
},
{
"ancillaryKey": "3e26f365d4030cd598ae24785582fd12",
"selectedSeatNo": "11E",
"paySeatCurrency": "USD",
"paySeatPrice": 16,
"desc": "windows"
}
]
}
]
}
],
"passengerBaggages": [
{
"passengerName": "YI/JOVAN",
"payBaggages": [
{
"segments": [
{
"flightNumber": 436,
"marketingCarrier": "QZ",
"depAirport": "CGK",
"arrAirport": "BKK",
"depTime": "202402291905",
"rbd": "Y"
}
],
"baggagePrices": [
{
"ancillaryKey": "f00bbb12c7ff80f982f0ea45d86ad439",
"type": 2,
"payBaggagePiece": 1,
"payBaggageWeight": 35,
"payBaggageCurrency": "USD",
"payBaggagePrice": "1.54"
}
]
}
]
}
],
"sessionId": "30142",
"status": 0
}Modified at 2025-10-13 09:29:39