Salt la conținut
Blog

API de disponibilitate hotelieră: furnizori lenți

Redacția Tekravel
Scris cu ajutorul IA

Tichetul vine de obicei cu un aer nevinovat. „Adăugați căutare de hoteluri pe pagina de rezervare — furnizorul ne-a dat un API de disponibilitate hotelieră, are sandbox, ar trebui să iasă într-un sprint.” Citiți documentația, trimiteți o cerere pentru doi adulți în Dubai, trei nopți, și primiți un răspuns. Apoi trimiteți aceeași cerere pentru un oraș cu mai multe proprietăți și nu vine nimic o vreme lungă și stânjenitoare. Când vine, e un document atât de mare încât parserul JSON începe să-și pună întrebări existențiale.

Acela e momentul în care sarcina își schimbă forma. Disponibilitatea hotelieră nu e o simplă căutare după cheie. E un fan-out: o întrebare a utilizatorului devine multe întrebări către mulți furnizori, iar fiecare răspunde în ritmul lui, în vocabularul lui, cu propria idee despre ce înseamnă o „cameră”. Clientul pe care îl construiți trebuie să rămână util cât timp fan-out-ul încă se rezolvă. Textul de față e despre proiectarea acestui client — scris pentru un dezvoltator care stăpânește bine REST și JSON și n-a fost niciodată nevoit să explice unui hotel de ce tariful nerambursabil al unui oaspete a apărut cu anulare gratuită.

De ce un API de disponibilitate hotelieră e mai lent decât endpoint-urile obișnuite

O căutare de zboruri și una de hoteluri par asemănătoare din afară: pleacă o interogare, se întorc opțiuni cu preț. Dedesubt, nu e aceeași problemă. Dacă ați citit notele noastre despre ce presupune de fapt integrarea unui API de rezervări de zboruri, știți deja că prețul găsit la căutare nu e mereu prețul rezervat. Hotelurile adaugă peste asta o a doua dificultate: volumul.

Un singur oraș poate avea sute de proprietăți. Fiecare proprietate vinde mai multe tipuri de camere. Fiecare tip de cameră se vinde sub mai multe planuri tarifare — cu mic dejun sau fără, rambursabil, nerambursabil, un tarif pentru membri, un tarif de pachet. Iar fiecare plan tarifar poate veni de la mai mulți furnizori: un bedbank, un channel manager, un contract direct, un angrosist cu care ați semnat pentru că alotmentul lui într-un anumit hotel era mai bun decât al oricui. Înmulțiți toate acestea și o căutare „simplă” devine un arbore mare, asamblat din mai multe surse care nu se înțeleg nici asupra numelor, nici asupra ID-urilor.

Așa că partea lentă e rareori codul în sine. E cel mai lent furnizor pe care ați ales să-l așteptați.

Rezultate progresive sau răspunsul complet: alegeți deliberat

Există două moduri oneste de a returna rezultatele unei căutări de hoteluri, iar majoritatea integrărilor ajung undeva la mijloc, unde nu e bine nimănui.

Așteptați totul. Backend-ul trimite cererile, așteaptă ca fiecare furnizor să răspundă sau să expire, apoi combină, elimină duplicatele, sortează și returnează o singură listă completă. Rezultatul e curat: o cerere, un răspuns, prețuri comparabile pentru că sunt toate pe masă. Prețul plătit: utilizatorul se uită la un spinner cât durează cel mai lent furnizor. De fiecare dată.

Livrați ce aveți. Backend-ul pornește fan-out-ul și returnează imediat un identificator de căutare. Clientul îl interoghează periodic sau ține deschis un stream și primește rezultatele în loturi, pe măsură ce furnizorii răspund. Primele hoteluri apar repede. Costul e complexitatea din tot restul: lista se reordonează în timp ce utilizatorul o citește, o etichetă „cel mai ieftin” se poate muta, iar un hotel venit de la un furnizor poate primi mai târziu un tarif mai mic de la altul.

Dacă interfața este o pagină de căutare în fața unui om, varianta progresivă e aproape întotdeauna cea corectă — omul răsfoiește, nu rulează un job batch, iar o pagină care se vede că lucrează bate o pagină care se gândește în tăcere. Dacă cel care consumă datele e o altă mașină — un job de comparare a tarifelor, un instrument de rezervări corporate care are nevoie de un singur răspuns definitiv — așteptarea e adesea mai simplă și corectă.

Orice ați alege, trei reguli țin un client progresiv sub control:

  • Fiecare lot poartă o stare de finalizare pentru căutare în ansamblu, ca clientul să știe diferența dintre „deocamdată nu mai sunt rezultate” și „nu vor mai fi rezultate deloc”.
  • Rezultatele sunt combinate pe server după o cheie stabilă de hotel, nu adăugate la coadă. Clientul n-ar trebui niciodată să deducă singur că două carduri sunt aceeași clădire.
  • Sortarea după preț e provizorie până la finalizarea căutării, iar interfața o spune deschis. Utilizatorii iartă o listă care se așază; nu iartă o etichetă „cel mai mic preț” care se dovedește greșită.

Cum modelați camerele și planurile tarifare ca să nu se prăbușească

Aici eșuează pe tăcute cele mai multe integrări hoteliere, iar eșecul iese la iveală luni mai târziu, ca tichet la suport, nu ca raport de bug.

Modelul tentant e plat: un hotel are o listă de oferte, fiecare ofertă are un nume de cameră și un preț. Se afișează frumos. Apoi un furnizor returnează „Deluxe King” și „Deluxe Room, 1 King Bed” pentru ceea ce e evident aceeași cameră, alt furnizor dă același nume pentru două camere cu adevărat diferite (una cu vedere spre oraș, una fără), iar un al treilea trimite un tarif cu preț pe noapte, în timp ce toți ceilalți dau prețul pe sejur. O listă plată nu vă poate spune pe care dintre ele îl aveți în față. Doar le afișează.

Un model care supraviețuiește contactului cu furnizori reali are cel puțin patru niveluri și le ține separate:

NivelCe conțineGreșeala de evitat
HotelPropriul ID stabil, mapat la codul fiecărui furnizorFolosirea ID-ului de hotel al unui furnizor drept cheie primară
CamerăOcupare, configurația paturilor, textul furnizorului despre cameră, păstrat cuvânt cu cuvânt„Curățarea” numelor de camere până când două camere diferite se contopesc într-una
Plan tarifarTipul de masă, rambursabilitatea, modul de plată, furnizorul de la care provineTratarea micului dejun sau a rambursabilității ca parte din numele camerei
PrețTotalul pentru sejur, moneda, ce taxe și comisioane sunt incluse și care se plătesc la hotelAfișarea unei sume pe noapte lângă sume pe sejur sau ascunderea taxelor plătite la sosire

Puteți să nu fiți de acord cu locul în care trec liniile — unele echipe separă ocuparea într-un nivel propriu, ceea ce e rezonabil odată ce vindeți rezervări cu mai multe camere. Ce nu puteți face e să contopiți niveluri doar pentru că interfața arată numai două dintre ele. Interfața poate aplatiza la randare. Datele nu au voie.

Un detaliu merită o propoziție separată: păstrați descrierea brută a camerei, exact cum a trimis-o furnizorul, alături de orice normalizați. Când un oaspete ajunge și primește altă cameră decât cea de pe voucher, primul lucru pe care îl va întreba oricine e ce a trimis de fapt furnizorul.

Politicile de anulare sunt date, nu un paragraf

Mulți furnizori returnează condițiile de anulare ca text liber: „Anulare gratuită până cu 3 zile înainte de sosire, după aceea penalitate de 1 noapte.” E foarte tentant să afișați șirul ca atare și să treceți mai departe.

Nu o faceți. Textul nu poate fi comparat, sortat, filtrat sau aplicat. Utilizatorul vrea să vadă doar tarifele rambursabile. Departamentul financiar vrea să știe ce rezervări devin nerambursabile mâine, ca agenția să-l poată contacta pe client înainte să treacă termenul. Fluxul de după rezervare trebuie să-i spună clientului, chiar în clipa în care apasă „anulează”, exact cât va plăti. Nimic din toate acestea nu funcționează pe o propoziție.

Modelați fiecare politică drept o listă ordonată de ferestre de penalizare: din acest moment până în acel moment, penalitatea este această sumă (sau această parte din sejur, sau atâtea nopți). Limitele sunt marcaje de timp cu fus orar — fusul orar al hotelului, nu al serverului și nu al utilizatorului — pentru că „cu 3 zile înainte de sosire” înseamnă alt moment în funcție de miezul nopții cui îl numărați. Păstrați textul original al furnizorului lângă versiunea structurată, afișați-o pe cea structurată și tratați orice nepotrivire dintre ele ca pe ceva de investigat, nu de ascuns.

Și reverificați politica la rezervare, nu doar la căutare. Politicile se schimbă între cele două apeluri mai des decât s-ar aștepta oricine.

Cât costă de fapt o greșeală

O căutare lentă vă costă conversii, ceea ce e rău, dar vizibil — cineva se va plânge. Eșecurile scumpe sunt cele tăcute.

Un tarif afișat ca rambursabil, pe care furnizorul îl tratează ca nerambursabil, înseamnă o dispută cu un client care are o captură de ecran, iar penalitatea ajunge de obicei să fie plătită chiar de agenție. Un preț pe noapte afișat ca total pe sejur vinde camere sub cost până când observă cineva de la contabilitate. O cameră contopită cu alta trimite o familie de patru persoane într-o cameră gândită pentru două. Taxele de plătit la hotel, neafișate niciodată, transformă o recenzie de cinci stele într-un chargeback. Fiecare dintre acestea e o decizie de modelare luată în primul sprint, de obicei sub eticheta „facem curat mai târziu”.

Cache: ce puteți păstra și ce nu aveți voie

Orice echipă care integrează un API hotelier ajunge să întrebe dacă poate pune rezultatele în cache, ca să facă căutarea mai rapidă și mai ieftină. Răspunsul e da, pentru unele lucruri, iar granița dintre ele contează mai mult decât orice cifră de performanță.

Conținutul static — nume de hoteluri, adrese, coordonate, fotografii, liste de facilități, descrieri de camere — se schimbă rar și e exact ce ar trebui să țineți în cache, agresiv, în propriul depozit. Verificați termenii furnizorului privind modul în care îl puteți stoca și afișa; unele licențe restricționează asta. Să-l aduceți live la fiecare căutare e lent și nu aduce niciun câștig.

Tarifele și disponibilitatea live sunt altă poveste. Un preț din cache e o presupunere despre cât va cere furnizorul, iar furnizorii nu vă onorează presupunerile. Un cache de scurtă durată pentru rezultatele căutării poate fi acceptabil la afișarea unei pagini — atâta timp cât fiecare drum spre rezervare reverifică prețul la furnizor înainte de a încasa bani, iar interfața tratează un preț schimbat ca pe un rezultat normal, nu ca pe o eroare. Unii furnizori limitează și cât de des puteți căuta în raport cu cât de des rezervați; un cache agresiv care le ascunde traficul real nu e o portiță pe care merită să vă bazați.

Ce nu aveți voie să puneți niciodată în cache e orice reprezintă un angajament: un token de preț reținut, o referință de rezervare, o cotație de anulare. Acestea aparțin unui singur utilizator și unui singur moment.

Înainte să declarați că ați terminat

O verificare scurtă, de rulat pe propria integrare înainte să treacă prin ea rezervări reale:

  • Căutarea returnează o stare de finalizare, iar clientul se comportă diferit înainte și după ea.
  • Hotelurile sunt identificate prin propriul ID, cu codul fiecărui furnizor mapat la el.
  • Camera, planul tarifar și prețul sunt obiecte separate în date, orice ar arăta ecranul.
  • Fiecare preț spune dacă e pe noapte sau pe sejur și ce se plătește la sosire.
  • Politicile de anulare sunt stocate ca ferestre de penalizare cu limite de timp, în fusul orar al hotelului, cu textul original păstrat.
  • Fluxul de rezervare reverifică prețul și recitește politica înainte de a încasa de la cineva.
  • Nimic din ce reprezintă un angajament nu e servit vreodată din cache.

Dacă vă întrebați dacă să construiți toate acestea direct pe fiecare furnizor sau să porniți de la o platformă care s-a lovit deja de aceste probleme, partea contractuală contează la fel de mult ca și codul — articolul nostru despre contractele cu un consolidator hotelier și tarifele bedbank arată ce să cereți. API-urile noastre de zboruri și hoteluri se deschid printr-o discuție, nu printr-o cheie self-service; dacă asta e calea pe care vreți s-o explorați, începeți discuția pe pagina travel APIs.

Fan-out-ul nu dispare niciodată. Un client bun doar încetează să se prefacă că nu există.

Redacția Tekravel

Departamentul de tehnologii de turism

Departamentul de tehnologii de turism al Tekravel scrie pentru industrie: proprietari de agenții, consolidatori și dezvoltatorii care îi integrează. Fiecare articol este verificat pe platforma pe care o descrie înainte de publicare.