Preskočiť na obsah
Blog

API dostupnosti hotelov: návrh pre pomalých dodávateľov

Redakcia Tekravel
Napísané s pomocou AI

Tiket zvyčajne vyzerá nevinne. „Pridajte vyhľadávanie hotelov na rezervačnú stránku — dodávateľ nám dal API dostupnosti hotelov, má sandbox, mal by to byť jeden šprint.“ Prečítate si dokumentáciu, pošlete požiadavku pre dvoch dospelých vo Viedni na tri noci a odpoveď príde. Potom pošlete tú istú požiadavku pre mesto s viacerými ubytovaniami a dlhú, nepríjemnú chvíľu sa nevráti nič. Keď sa napokon vráti, je to dokument taký veľký, že váš JSON parser začne prehodnocovať svoje životné rozhodnutia.

V tej chvíli sa práca mení. Dostupnosť hotelov nie je lookup. Je to fan-out: jedna otázka od vášho používateľa sa zmení na mnoho otázok mnohým dodávateľom, z ktorých každý odpovedá vlastnou rýchlosťou, vlastnou slovnou zásobou a s vlastnou predstavou o tom, čo je „izba“. Klient, ktorého postavíte, musí byť užitočný po celý čas, kým sa ten fan-out ešte rieši. Tento text je o návrhu takého klienta — pre vývojára, ktorý dobre pozná REST a JSON a ešte nikdy nemusel hotelu vysvetľovať, prečo sa nevratná sadzba hosťa zobrazila ako bezplatné storno.

Prečo je API dostupnosti hotelov pomalšie než endpointy, na ktoré ste zvyknutí

Zvonka vyzerajú vyhľadávanie letov a vyhľadávanie hotelov podobne: dotaz odíde, ocenené možnosti sa vrátia. Pod povrchom to nie je ten istý problém. Ak ste čítali naše poznámky o tom, čo integrácia API na rezerváciu leteniek naozaj obnáša, viete, že cena, ktorú vyhľadáte, nie je vždy cena, ktorú zarezervujete. Hotely k tomu pridávajú druhú ťažkosť: objem.

Jedno mesto môže mať stovky ubytovaní. Každé predáva niekoľko typov izieb. Každý typ izby sa predáva v niekoľkých rate plánoch — s raňajkami, bez nich, vratný, nevratný, členská cena, balíková cena. Každý rate plán môže prísť z viac než jedného zdroja: z bedbanky, z channel managera, z priamej zmluvy, od veľkoobchodníka, s ktorým ste podpísali zmluvu, lebo jeho allotment v jednom hoteli bol lepší než ktokoľvek iný. Vynásobte to a „jednoduché“ vyhľadávanie je veľký strom poskladaný z niekoľkých zdrojov, ktoré sa nezhodnú na názvoch ani na ID.

Pomalou časťou teda len zriedka býva váš kód. Je to najpomalší dodávateľ, na ktorého ste sa rozhodli čakať.

Priebežné výsledky alebo úplná odpoveď: vyberte si vedome

Existujú dva poctivé spôsoby, ako vrátiť výsledky vyhľadávania hotelov, a väčšina integrácií skončí niekde nešťastne uprostred.

Počkajte na všetko. Backend rozošle dotaz, počká, kým každý dodávateľ odpovie alebo vyprší timeout, zlúči, odstráni duplicity, zoradí a vráti jeden úplný zoznam. Výsledok je čistý: jedna požiadavka, jedna odpoveď, ceny, ktoré sa dajú porovnať, lebo sú všetky na stole. Cenou je, že používateľ zakaždým hľadí na spinner tak dlho, ako trvá vášmu najpomalšiemu dodávateľovi.

Posielajte, čo máte. Backend spustí fan-out a okamžite vráti search handle. Klient ho polluje alebo drží otvorený stream a dostáva výsledky v dávkach, ako dodávatelia odpovedajú. Prvé hotely sa objavia rýchlo. Cenou je zložitosť všade inde: zoznam sa preusporadúva, kým ho používateľ číta, štítok „najlacnejší“ sa môže presunúť a hotel, ktorý sa objavil od jedného dodávateľa, môže neskôr dostať lacnejšiu sadzbu od iného.

Ak je vaším rozhraním vyhľadávacia stránka pred človekom, priebežné výsledky sú takmer vždy správne — ten človek prehliada, nespúšťa dávkovú úlohu, a stránka, ktorá viditeľne pracuje, je lepšia než stránka, ktorá potichu premýšľa. Ak je spotrebiteľom iný stroj — úloha na porovnávanie cien, firemný rezervačný nástroj, ktorý potrebuje jednu definitívnu odpoveď — čakanie je často jednoduchšie a správne.

Nech si vyberiete čokoľvek, tri pravidlá udržia priebežného klienta pri zmysloch:

  • Každá dávka nesie stav dokončenia celého vyhľadávania, aby klient rozlíšil „zatiaľ žiadne ďalšie výsledky“ od „už nikdy žiadne ďalšie výsledky“.
  • Výsledky sa na serveri zlučujú podľa stabilného kľúča hotela, nepridávajú sa na koniec. Klient by nikdy nemal sám zisťovať, že dve karty sú tá istá budova.
  • Radenie podľa ceny je predbežné, kým sa vyhľadávanie nedokončí, a rozhranie to hovorí. Používatelia odpustia zoznam, ktorý sa ustáli; neodpustia štítok „najnižšia cena“, ktorý sa ukáže ako nepravdivý.

Modelovanie izieb a rate plánov tak, aby sa nezrútili

Tu väčšina hotelových integrácií potichu zlyhá a zlyhanie sa ukáže o mesiace neskôr ako tiket podpory, nie ako hlásenie chyby.

Lákavý model je plochý: hotel má zoznam ponúk, každá ponuka má názov izby a cenu. Pekne sa vykreslí. Potom jeden dodávateľ vráti „Deluxe King“ a „Deluxe Room, 1 King Bed“ pre izbu, ktorá je zjavne tá istá, iný dodávateľ vráti rovnaký názov pre dve naozaj odlišné izby (jednu s výhľadom na mesto, jednu bez neho) a tretí vráti sadzbu za noc, kým všetci ostatní uvádzajú cenu za celý pobyt. Plochý zoznam vám nepovie, na ktorý prípad sa pozeráte. Iba ich zobrazí.

Model, ktorý prežije stret so skutočnými dodávateľmi, má aspoň štyri úrovne a drží ich oddelene:

ÚroveňČo obsahujeChyba, ktorej sa vyhnúť
HotelVaše vlastné stabilné ID namapované na kód každého dodávateľaPoužitie hotelového ID dodávateľa ako primárneho kľúča
IzbaObsadenosť, konfigurácia postelí, pôvodný text izby od dodávateľa doslovne„Upratovanie“ názvov izieb, až kým dve rôzne izby nesplynú do jednej
Rate plánBoard basis, vratnosť, spôsob platby, dodávateľ, od ktorého prišielZaradenie raňajok alebo vratnosti do názvu izby
CenaCelková suma za pobyt, mena, ktoré dane a poplatky sú v nej a ktoré sa platia v hoteliZobrazenie sumy za noc vedľa súm za pobyt alebo skrývanie poplatkov splatných pri príchode

Môžete nesúhlasiť s tým, kde vedú hranice — niektoré tímy vyčleňujú obsadenosť do samostatnej úrovne, čo je rozumné, keď predávate rezervácie viacerých izieb. Čo nemôžete, je zlučovať úrovne len preto, že rozhranie ukazuje dve z nich. Rozhranie môže sploštiť pri vykresľovaní. Dáta nie.

Jeden detail si zaslúži vlastnú vetu: popri všetkom, čo normalizujete, si uchovajte surový popis izby od dodávateľa. Keď hosť príde a dostane inú izbu, než má na voucheri, prvé, čo sa každý spýta, je, čo dodávateľ naozaj poslal.

Storno podmienky sú dáta, nie odsek textu

Mnohí dodávatelia vracajú storno podmienky ako voľný text: „Bezplatné storno do 3 dní pred príchodom, potom poplatok vo výške 1 noci.“ Je veľmi lákavé ten reťazec zobraziť a ísť ďalej.

Nerobte to. Text sa nedá porovnávať, radiť, filtrovať ani vymáhať. Váš používateľ chce filtrovať vratné sadzby. Finančný tím chce vedieť, ktoré rezervácie sa zajtra stanú nevratnými, aby agentúra stihla kontaktovať klienta pred uplynutím lehoty. Váš proces po rezervácii musí zákazníkovi v momente, keď stlačí storno, povedať presne, koľko mu bude účtované. Nič z toho nefunguje nad vetou.

Každú podmienku modelujte ako zoradený zoznam okien s poplatkami: od tohto okamihu do tamtoho je poplatok táto suma (alebo tento podiel z pobytu, alebo toľko nocí). Hranice sú časové pečiatky s časovým pásmom — pásmom hotela, nie vášho servera a nie používateľa — pretože „3 dni pred príchodom“ je iný okamih podľa toho, čiu polnoc počítate. Pôvodný text dodávateľa uložte vedľa štruktúrovanej verzie, zobrazujte štruktúrovanú verziu a nesúlad medzi nimi berte ako niečo na preskúmanie, nie na skrytie.

A podmienky overte znova pri rezervácii, nielen pri vyhľadávaní. Medzi týmito dvoma volaniami sa menia častejšie, než ktokoľvek čaká.

Koľko chyba naozaj stojí

Pomalé vyhľadávanie vás stojí konverzie, čo je zlé, ale viditeľné — niekto sa sťažuje. Drahé zlyhania sú tie tiché.

Sadzba zobrazená ako vratná, ktorú dodávateľ považuje za nevratnú, znamená spor so zákazníkom, ktorý má snímku obrazovky, a poplatok napokon zvyčajne zaplatí samotná agentúra. Cena za noc zobrazená ako celková suma za pobyt predáva izby pod nákladmi, kým si to niekto v účtovníctve nevšimne. Izba zlúčená s inou izbou pošle štvorčlennú rodinu do izby pre dvoch. Poplatky splatné v hoteli, ktoré sa nikdy nezobrazili, premenia päťhviezdičkovú recenziu na chargeback. Každé z toho je rozhodnutie o modelovaní urobené v prvom šprinte, zvyčajne s nálepkou „neskôr to upraceme“.

Cachovanie: čo si smiete ponechať a čo nie

Každý tím, ktorý integruje hotelové API, sa napokon spýta, či môže výsledky cachovať, aby bolo vyhľadávanie rýchlejšie a lacnejšie. Odpoveď je áno, pre niektoré veci, a hranica medzi nimi je dôležitejšia než akékoľvek číslo o výkone.

Statický obsah — názvy hotelov, adresy, súradnice, fotografie, zoznamy vybavenia, popisy izieb — sa mení zriedka a presne ten by ste mali agresívne cachovať vo vlastnom úložisku. Overte si podmienky dodávateľa, ako ho smiete ukladať a zobrazovať; niektoré licencie to obmedzujú. Načítavať ho naživo pri každom vyhľadávaní je pomalé a bez úžitku.

Živé sadzby a dostupnosť sú iná vec. Cachovaná cena je odhad toho, čo dodávateľ bude účtovať, a dodávatelia vaše odhady nerešpektujú. Krátkodobé cachovanie výsledkov vyhľadávania môže byť prijateľné na zobrazenie stránky — pokiaľ každá rezervačná cesta pred inkasom peňazí znova ocení ponuku u dodávateľa a rozhranie berie zmenenú cenu ako bežný výsledok, nie chybu. Niektorí dodávatelia navyše obmedzujú pomer vyhľadávaní k rezerváciám; agresívne cachovanie, ktoré pred nimi skrýva vašu skutočnú prevádzku, nie je medzera, na ktorú sa oplatí spoliehať.

Nikdy necachujte nič, čo predstavuje záväzok: držaný cenový token, rezervačné číslo, ponuku storno poplatku. Tie patria jednému používateľovi a jednému okamihu.

Skôr než poviete, že je hotovo

Krátka kontrola, ktorú sa oplatí spustiť nad vlastnou integráciou, skôr než ponesie skutočné rezervácie:

  • Vyhľadávanie vracia stav dokončenia a klient sa pred ním a po ňom správa inak.
  • Hotely sú kľúčované vaším vlastným ID a kód každého dodávateľa je naň namapovaný.
  • Izba, rate plán a cena sú vo vašich dátach samostatné objekty, nech obrazovka ukazuje čokoľvek.
  • Každá cena hovorí, či je za noc alebo za pobyt, a čo sa platí pri príchode.
  • Storno podmienky sú uložené ako časované okná poplatkov v časovom pásme hotela a pôvodný text je zachovaný.
  • Rezervačná cesta znova ocení ponuku a znova načíta podmienky, skôr než komukoľvek niečo zaúčtuje.
  • Nič, čo predstavuje záväzok, sa nikdy neposkytuje z cache.

Ak zvažujete, či toto všetko postaviť priamo voči jednotlivým dodávateľom, alebo začať od platformy, ktorá sa s týmito problémami už stretla, zmluvná stránka je rovnako dôležitá ako kód — náš článok o zmluvách hotelového konsolidátora a sadzbách bedbank hovorí, čo žiadať. Naše letecké a hotelové API sa otvárajú rozhovorom, nie samoobslužným kľúčom; ak je to cesta, ktorú chcete preskúmať, začnite rozhovor na stránke travel APIs.

Fan-out nikdy nezmizne. Dobrý klient len prestane predstierať, že tam nie je.

Redakcia Tekravel

Rubrika cestovných technológií

Rubrika cestovných technológií Tekravel píše pre odvetvie: majiteľov agentúr, konsolidátorov a vývojárov, ktorí ich integrujú. Každý článok je pred vydaním overený na platforme, ktorú opisuje.