Қонақүй 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 болғанда GET /v1/hotels/search/{searchId} арқылы сұрап отыруға арналған 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 міндетті) оны растайды.