- API Integration Guide
- Flight Ticket Distribution Direct Connect API
- Order Management API
- Schedule Change API
- Cache Refresh API
- Ancillary Order Management API
Order Copy
Deprecated
POST
/api/flight/order
Interface Specification#
Data Security
abcdefghigklmnopqrstuvwxyz0123456789After encryption:
8Z3dZzqn05FmiuBLowExK0CAbs4TY2GorC2dDPVlsn/tP+VuJGePqIMv1uSaVErrStatus Code#
| Status Code | Explanation | Note |
|---|---|---|
| 0 | Success | |
| 1 | All seats have been sold | |
| 2 | Insufficient Cabin Seats | |
| 3 | Failed due to other reasons | |
| 5 | Program exception | |
| 6 | Reservation Failed | Price Change During Reservation |
| 7 | PNR is Null | Upstream Not Successfully Booked |
| 8 | Not Matched the Flight Information | No Matching Flight Results at the Pricing Stage |
| 9 | Specified Fare Not Found | No Matching Flight Results at the Pricing Stage |
| 10 | Airline or GDS Timeout | |
| 101 | Duplicate Booking Returned from Upstream | |
| 200 | Airline or GDS Service Exception | Service Exception |
| 211 | Error in Passenger Information Request | For example, child passenger has booked an adult ticket |
| 212 | Error in Name Format | |
| 213 | Error in Name Length | |
| 214 | Error in Passenger Count | Does not comply with adults 1-9, children 0-8, infants 0 |
| 215 | Error in Operating or Validating Carrier | |
| 217 | Baggage Booking Failed |
Request
Body Params application/json
Example
{
"contact": {
"email": "cs.flightnotice@oneworldtrip.cn",
"mobile": "86 121313313",
"name": "oneworldtrip"
},
"cutOffTime": 19500,
"modifyTktNumType": 1,
"orderNumber": 917049394071227300,
"passengerBaggages": [
{
"passengerName": "YI/JOVAN",
"payBaggages": [
{
"baggagePrices": [
{
"ancillaryKey": "f00bbb12c7ff80f982f0ea45d86ad439",
"payBaggageCurrency": "USD",
"payBaggagePiece": 1,
"payBaggagePrice": 1.54,
"payBaggageWeight": 35,
"type": 2
}
],
"segments": [
{
"arrAirport": "BKK",
"depAirport": "CGK",
"depTime": "202401201905",
"flightNumber": 436,
"marketingCarrier": "TG",
"rbd": "Y"
}
]
}
]
}
],
"passengerSeats": [
{
"passengerName": "GUO/TOM",
"paySeats": [
{
"seatPrices": [
{
"ancillaryKey": "023456",
"desc": "windows",
"paySeatCurrency": "USD",
"paySeatPrice": 16,
"selectedSeatNo": "10A"
}
],
"segments": [
{
"arrAirport": "BKK",
"depAirport": "CGK",
"depTime": "202401201905",
"flightNumber": 436,
"marketingCarrier": "TG",
"rbd": "Y"
},
{
"arrAirport": "CGK",
"depAirport": "BKK",
"depTime": "202401310820",
"flightNumber": 4330,
"marketingCarrier": "TG",
"rbd": "Y"
}
]
}
]
}
],
"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": [
{
"aircraftCode": "123",
"arrAirport": "BKK",
"arrTime": "202401202235",
"codeShare": false,
"depAirport": "CGK",
"depTime": "202401201905",
"duration": "210",
"flightNumber": 436,
"marketingCarrier": "TG",
"operatingCarrier": "TG",
"operatingFlightNumber": 121,
"rbd": "Y"
}
],
"retSegments": [
{
"aircraftCode": "qaw",
"arrAirport": "CGK",
"arrTime": "202401311155",
"codeShare": true,
"depAirport": "BKK",
"depTime": "202401310820",
"duration": "215",
"flightNumber": 4330,
"marketingCarrier": "TG",
"operatingCarrier": "SG",
"operatingFlightNumber": 110,
"rbd": "Y"
}
]
},
"sessionId": "210455864884402699",
"tripType": "2",
"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,
"passengerBaggages": [
{
"passengerName": "YI/JOVAN",
"payBaggages": [
{
"baggagePrices": [
{
"ancillaryKey": "f00bbb12c7ff80f982f0ea45d86ad439",
"payBaggageCurrency": "USD",
"payBaggagePiece": 1,
"payBaggagePrice": 1.54,
"payBaggageWeight": 35,
"type": 2
}
],
"segments": [
{
"arrAirport": "BKK",
"depAirport": "CGK",
"depTime": "202401201905",
"flightNumber": 436,
"marketingCarrier": "TG",
"rbd": "Y"
}
]
}
]
}
],
"passengerSeats": [
{
"passengerName": "GUO/TOM",
"paySeats": [
{
"seatPrices": [
{
"ancillaryKey": "023456",
"desc": "windows",
"paySeatCurrency": "USD",
"paySeatPrice": 16,
"selectedSeatNo": "10A"
}
],
"segments": [
{
"arrAirport": "BKK",
"depAirport": "CGK",
"depTime": "202401201905",
"flightNumber": 436,
"marketingCarrier": "TG",
"rbd": "Y"
},
{
"arrAirport": "CGK",
"depAirport": "BKK",
"depTime": "202401310820",
"flightNumber": 4330,
"marketingCarrier": "TG",
"rbd": "Y"
}
]
}
]
}
],
"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": [
{
"aircraftCode": "123",
"arrAirport": "BKK",
"arrTime": "202401202235",
"codeShare": false,
"depAirport": "CGK",
"depTime": "202401201905",
"duration": "210",
"flightNumber": 436,
"marketingCarrier": "TG",
"operatingCarrier": "TG",
"operatingFlightNumber": 121,
"rbd": "Y"
}
],
"retSegments": [
{
"aircraftCode": "qaw",
"arrAirport": "CGK",
"arrTime": "202401311155",
"codeShare": true,
"depAirport": "BKK",
"depTime": "202401310820",
"duration": "215",
"flightNumber": 4330,
"marketingCarrier": "TG",
"operatingCarrier": "SG",
"operatingFlightNumber": 110,
"rbd": "Y"
}
]
},
"sessionId": "210455864884402699",
"tripType": "2",
"vendorCode": "IST-PETOUR",
"agentCode": "123"
}'Responses
🟢200success
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-22 09:40:07