Ruka hadi maudhui
Demo ya moja kwa moja

API ya Hoteli

Tafuta malazi 1.5M+ kwa msimbo wa jiji (mtindo wa IATA, k.m. DXB) au kwa misimbo ya hoteli unayohifadhi kutoka katalogi yetu, soma bei za kila chumba pamoja na mpango wa milo na sera ya kughairi, thibitisha na uweke nafasi, ghairi kulingana na sera.

  1. Utafutaji
  2. Vyumba na bei
  3. Ukaguzi wa bei
  4. Weka nafasi
  5. Ghairi

Utafutaji

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.

Kwa wait=true unapata seti kamili ya matokeo; kwa wait=false unapata searchId ya kuuliza kupitia GET /v1/hotels/search/{searchId} — tuma tarehe zile zile na idadi ile ile ya vyumba ili funguo za bei ziendelee kuweza kuwekewa nafasi. Kila hoteli hubeba maudhui yake (jina, nyota, anwani, eneo la kijiografia, picha kuu, huduma) na bei nafuu zaidi kwa kila chumba pamoja na rateKey isiyo na maana ya ndani, jumla na bei za kila usiku, mpango wa milo, uwezekano wa kurejeshewa pesa na tarehe ya mwisho ya kughairi.

Vyumba na bei

GET /v1/hotels/{hotelCode}/rooms?rateKey=… huorodhesha kila aina ya chumba na bei ya malazi moja kwa kipindi cha kukaa kilichotafutwa: aina za vitanda, idadi ya wakaaji, milo, sera, kodi na ada zilizoainishwa, na ikiwa bei inarejesheka.

Ukaguzi wa bei

POST /v1/hotels/rates/{rateKey}/check huthibitisha kuwa bei bado inaweza kuwekewa nafasi na hurudisha bei ya mwisho na sera. Fanya hivi mara moja kabla ya kuweka nafasi: 409 price_changed au rate_expired hapa ni nafuu zaidi kuliko uhifadhi ulioshindwa.

Weka nafasi

POST /v1/hotels/bookings ikiwa na rateKey, mmiliki wa uhifadhi, wageni kwa kila chumba na mawasiliano, pamoja na Idempotency-Key. Jibu ni uhifadhi pamoja na kumbukumbu yake, uthibitisho wa msambazaji na data ya vocha. GET /v1/hotels/bookings/{bookingId} huurudisha tena wakati wowote.

Ghairi

GET /v1/hotels/bookings/{bookingId}/cancellation-quote hurudisha adhabu kulingana na sera kwa wakati huu; POST /v1/hotels/bookings/{bookingId}/cancel (Idempotency-Key inahitajika) hukutekeleza.