Dependency: Verify or getOffer function should be called in prior to this call.
In a booking process, please call the 'seatAvailability' API to get seat availability information after price verification via 'verify' or 'getOffer'. Steps:
API sequence
Search - Verify- seatAvailability - Order - Pay
getOffer - seatAvailability - Order - Pay
Pass 'offerId' in 'seatAvailability' requests:
From 'verify': Use sessionId directly. From 'getOffer': Use its offerId.
In the Order step, use the productCode to add specific seat to the ticket order.
ThesessionIdreturned by price verification api(verify.do). Only required in Non-independent mode.
offerIdstringRequired
TheofferIDreturned by get offer api(getOffers.do). Only required in Non-independent mode.
carrierstringRequired
The IATA code of MSC(known as Most Significant Carrier) of the itinerary.
Responses
200Success
application/json
statusinteger · enumRequired
214: Session ID invalid or expired.
215: Segment index missing.
216: Seat selection failed.
217: Unknown error.
218: The airline don’t support seat selection currently.
219: The route don’t support seat selection currently.
220: illegal request parameter.
221: Fare family is empty and not configured with lowest price fare family.
223: The ratio of seat quotation requests to payment orders has exceeded the allowed threshold.
Possible values:
msgstring · nullableOptional
It serves as an additional description of the response result. Especially when the interface reports an error (status !=0), it is usually a human-readable error message. Note: Do not use this field in any programming scenarios. For example, do not judge whether the interface responds successfully based on this field. Instead, you should only determine it by checking whether the status is equal to0at any time.
POST /seatAvailability.do HTTP/1.1
Accept: text
Accept-Encoding: text
x-atlas-client-id: NAR65434_api_1
x-atlas-client-secret: text
Content-Type: application/json
Content-Length: 52
{
"sessionId": "f623b2c4-a1ed-4e8f-9cfb-5de1ae7739d6"
}