API за хотели
Търсете сред 1.5M+ места за настаняване по код на град (в стил IATA, напр. DXB) или по кодовете на хотели, които съхранявате от нашия каталог; получавайте тарифи на ниво стая с режим на хранене и условия за анулиране, валидирайте и резервирайте, анулирайте според условията.
Търсене
POST /v1/hotels/search with a destination and check-in/out dates and one to eight rooms (adults and child ages per room). The destination is a cityCode (IATA-style, e.g. "DXB" — GET /v1/content/cities lists them), a list of hotelCodes from the catalogue you store on your side (GET /v1/content/hotels per city), or a geo circle. Name matching is yours to do against your stored list; availability is always asked by code.
С wait=true получавате пълния набор резултати; с wait=false — searchId за периодични проверки с GET /v1/hotels/search/{searchId}; подавайте същите дати и брой стаи, за да останат ключовете на тарифите годни за резервация. Всеки хотел съдържа своето съдържание (име, звезди, адрес, геоданни, основна снимка, удобства) и най-евтината тарифа за всяка стая с непрозрачен rateKey, общата цена и цената на нощувка, режима на хранене, възможността за възстановяване и крайния срок за анулиране.
Стаи и тарифи
GET /v1/hotels/{hotelCode}/rooms?rateKey=… изброява всички типове стаи и тарифи на един обект за търсения престой: типове легла, капацитет, хранене, условия, отделно посочени данъци и такси и дали тарифата е с възможност за възстановяване.
Проверка на тарифата
POST /v1/hotels/rates/{rateKey}/check потвърждава, че тарифата все още е достъпна за резервация, и връща окончателната цена и условия. Правете това непосредствено преди резервацията: 409 price_changed или rate_expired тук струва много по-малко от неуспешна резервация.
Резервация
POST /v1/hotels/bookings с rateKey, титуляря, гостите по стаи и контакт, плюс Idempotency-Key. Отговорът е резервацията с нейната референция, потвърждението от доставчика и данните за ваучера. GET /v1/hotels/bookings/{bookingId} я връща отново по всяко време.
Анулиране
GET /v1/hotels/bookings/{bookingId}/cancellation-quote връща неустойката според условията в този момент; POST /v1/hotels/bookings/{bookingId}/cancel (изисква се Idempotency-Key) я потвърждава.