Salt la conținut
Blog

Comparație API de turism: evaluează axele, nu furnizorii

Redacția Tekravel
Scris cu ajutorul IA

Ai trei prezentări de furnizori deschise în trei taburi. Fiecare are un slide cu o listă lungă de companii aeriene, un slide cu numărul de hoteluri, un sandbox, REST și JSON, și o adresă de suport. Construiești un tabel, pui o bifă în fiecare celulă, iar tabelul se termină la egalitate. Așa se încheie de obicei o comparație de API-uri de turism făcută ca listă de funcționalități, și e finalul greșit: diferențele care îți vor decide anul următor apar abia după lansare. La rezervarea care a reușit la furnizor, dar a expirat în timeout la tine. La rambursarea pe care n-o poate procesa nimeni. La compania aeriană care era pe listă, dar pe care nu poți emite bilet pe ruta asta.

Textul e pentru dezvoltatorul sau liderul tehnic care trebuie să ia decizia și s-o apere mai târziu. Nu face un clasament al furnizorilor. Îți dă axe de comparat, un plan de probă care își petrece timpul pe eșecuri și un set scurt de întrebări care îți arată repede dacă vorbești cu un furnizor sau cu revânzătorul furnizorului altcuiva.

De ce lista de funcționalități se termină mereu la egalitate

O listă de funcționalități întreabă dacă o capabilitate există. Aproape orice API de turism poate spune da la aproape orice rând, pentru că rândurile sunt scrise la nivelul paginii de marketing: căutare, preț, rezervare, anulare, emitere, webhooks, sandbox. Întrebarea care le deosebește nu e dacă cancel există, ci ce se întâmplă când îl apelezi pe o rezervare deja emisă, cu douăsprezece ore înainte de plecare, pe un tarif cu penalitate, printr-o rută unde conținutul a venit de la un terț. Lista n-are coloană pentru asta.

Mai e o problemă. Lista o completează de obicei chiar furnizorul. Notezi propria lui descriere.

O comparație de API-uri de turism construită pe axe, nu pe furnizori

Înlocuiește grila furnizor-pe-funcționalitate cu axe pe care le punctezi tu, din dovezi strânse în perioada de probă. Tabelul de mai jos e cel pe care l-am folosi noi. Poți pondera rândurile altfel — o afacere doar cu hoteluri se preocupă mai puțin de emitere — și merită să-l contești înainte să-l adopți.

AxăCe întreabă listaCe trebuie aflat de faptCum sună un răspuns slab
AcoperireCâte companii aeriene și hoteluri?Câte pot fi căutate, rezervate ȘI emise sau confirmate prin acest API, pe piețele taleUn singur număr mare, fără defalcare
ProfunzimeExistă endpoint de anulare?Ce acțiuni de după rezervare sunt automatizate pe fiecare sursă de conținut: void, rambursare, reemitere, corectarea numelui, servicii suplimentare„Se ocupă echipa noastră de operațiuni”
Integritatea prețuluiPrețul e în timp real?Cât de des diferă prețul la rezervare de cel de la căutare și cum îți spune API-ul asta„Prețurile sunt mereu live”
Semantica erorilorSunt documentate erorile?Dacă o eroare îți spune în ce stare e rezervarea, nu doar că ceva a eșuatUn cod generic pentru orice eșec
Idempotență—Dacă un apel de rezervare repetat poate crea o a doua rezervareTăcere, apoi „n-am întâlnit așa ceva”
Furnizorul contractual—Al cui e contractul, al cui codul IATA, prin al cui BSP trece biletul„Lucrăm cu toate marile GDS-uri”
Acces și suportExistă sandbox?Cine răspunde când un PNR real se blochează, și cât de repedeUn formular de tichet și niciun contact cu nume

Două dintre rânduri nu au nicio întrebare în listă. Nu e întâmplător: sunt rândurile care costă cel mai mult când merg prost și cele pe care o prezentare comercială e cel mai puțin dispusă să le pomenească singură.

Acoperirea nu e profunzime

Lista de companii aeriene e cel mai înșelător slide din orice prezentare. O listă de câteva sute de transportatori poate însemna lucruri diferite, și doar unul dintre ele e ce cauți.

Unii dintre acești transportatori vin printr-un GDS și pot fi rezervați și emiși de la un capăt la altul. Alții vin prin conexiuni NDC, unde căutarea poate merge bine, dar servisarea după rezervare — modificări, rambursări parțiale, adăugarea unui bagaj — poate fi încă manuală pentru compania respectivă. Alții sunt low-cost, cu conținut agregat de la alt revânzător: îi poți afișa, uneori îi poți rezerva, iar apoi biletul vine pe o rută pe care n-o controlezi, într-un termen pe care nu-l poți promite clientului. Și unii sunt pe listă pentru că odată un tarif a apărut într-un răspuns de căutare.

Un transportator pe care îl poți arăta, dar nu-l poți emite, nu e acoperire. Pentru un produs de retail e mai rău decât absența, pentru că clientul îl alege, plătește și apoi așteaptă.

Hotelurile au aceeași formă, cu alte cuvinte. Un număr de proprietăți include unități pe care furnizorul le-a mapat și unități pe care nu le-a mapat; tarife statice salvate în cache săptămâna trecută lângă disponibilitate live; camere în allotment cu perioadă de release lângă stoc în free sale. Cere numărul celor rezervabile live în orașele în care vinzi și întreabă cum sunt unificate duplicatele dintre proprii lor furnizori — același hotel apărând de trei ori la trei prețuri e un tichet de suport care stă să apară.

Testul practic e îngust. Notează cele douăzeci de rute și douăzeci de orașe hoteliere care fac cea mai mare parte din volumul tău — să zicem București–Dubai, Cluj–Antalya, hoteluri în Dubai și în Hurghada — și cere-i furnizorului să-ți arate exact acestea funcționând cap-coadă în sandbox: căutare, preț, rezervare, emitere sau confirmare, anulare. Un furnizor care are profunzime o face fără mofturi. Unul care are doar slide-ul va începe să vorbească despre slide.

Ce testezi în perioada de probă: căile de eroare, nu cele fericite

Orice sandbox rezervă cu succes un bilet dus la clasa economic pe o rută liniștită. Pentru asta a fost construit. Traficul tău de producție își va petrece o parte serioasă din viață pe celelalte căi, iar perioada de probă e singurul moment ieftin în care le poți vedea.

Folosește-o ca să parcurgi lista de mai jos și notează ce a returnat API-ul lângă ce s-a dovedit adevărat după aceea:

  • Schimbare de preț între căutare și rezervare. Apelul de rezervare eșuează, reușește la noul preț sau întoarce un răspuns distinct care cere confirmare? Interfața ta poate face diferența fără să parseze un text de mesaj?
  • Ofertă expirată. Caută, așteaptă mai mult decât durata de viață a ofertei declarată de furnizor, apoi rezervă. Expirarea e o eroare specifică sau aceeași eroare ca „furnizor indisponibil”?
  • Epuizat la rezervare. Stoc care dispare între preț și rezervare. În ce stare e rezervarea și se eliberează autorizarea de plată?
  • Reîncercare după timeout. Trimite o cerere de rezervare, întrerupe conexiunea înainte de răspuns, apoi trimite-o din nou. Ai acum un PNR sau două? Testul ăsta singur îți spune mai mult despre un furnizor decât tot restul perioadei de probă la un loc.
  • Rezervare creată, emitere eșuată. Poate API-ul să raporteze un PNR care există, dar nu e emis, și îți spune termenul-limită de emitere?
  • Eșec parțial. O cerere hotelieră pentru mai multe camere în care una se confirmă și alta nu. Un dus-întors în care segmentele vin din surse diferite.
  • Anulare în afara ferestrei gratuite. Penalitatea e comunicată înainte de confirmare sau o descoperi pe factură?
  • Furnizor căzut. Întreabă furnizorul cum se simulează o cădere. Dacă nu știe, întreabă cum au aflat clienții lui cum se comportă sistemul atunci.

Pentru fiecare caz punctezi două lucruri. Întâi: îți spune API-ul adevărul despre starea rezervării? Apoi: poate codul tău să acționeze pe baza acestui adevăr fără ca un om să citească text liber? Cu un API care eșuează clar se trăiește mai ușor decât cu unul care reușește ambiguu.

Am scris mai pe larg despre partea de zboruri în ce nu spune documentația API-urilor de rezervări zboruri, iar despre proiectarea unui client pentru furnizori hotelieri lenți în articolul despre disponibilitatea hotelieră. Ambele merg bine lângă un plan de probă.

Întrebări care dau de gol un agregator subțire

Nu e nimic rău într-un agregator. Majoritatea conținutului de turism ajunge la majoritatea vânzătorilor printr-unul. Riscul e cel subțire: un strat care revinde API-ul altui strat, adaugă o marjă și nu deține nici contractul cu furnizorul, nici biroul de operațiuni. Când ceva se strică, răspunsul trebuie să urce prin două companii și să se întoarcă.

Cinci întrebări scot asta repede la iveală:

  1. Cine e furnizorul contractual pentru această rezervare? Pe contractul cui cu compania aeriană sau hotelul se sprijină?
  2. Prin codul IATA și BSP-ul cui trece biletul? Dacă răspunsul e „al unui partener”, întreabă cine primește ADM-ul când e încălcată o regulă tarifară.
  3. Când apelez cancel, ce se întâmplă la voi? Un apel automat către furnizor sau o coadă pe care o preia un om?
  4. Pot vedea eroarea din amonte? Un strat subțire tinde să turtească orice eșec într-un singur cod, pentru că nu înțelege pe deplin erorile pe care le primește.
  5. Pe cine sun pentru o rezervare live blocată și pe cine sună ei? Numără verigile.

Niciunul dintre răspunsuri nu descalifică singur. Codul IATA al unui partener poate fi în regulă dacă contractul spune clar cine suportă nota de debit. Contează ca furnizorul să răspundă precis și repede. Răspunsurile vagi de acum sunt cele pe care le vei primi mai târziu, în producție, la o oră mai proastă.

Cât te costă o alegere greșită

Integrarea e partea ieftină. Cele scumpe vin mai târziu și nu apar în nicio estimare.

Un bug de rezervare dublă înseamnă un client taxat de două ori și un PNR de găsit și anulat de mână, poate după ce s-a închis fereastra gratuită de void. O rezervare reușită în amonte în timp ce partea ta a înregistrat un eșec înseamnă un loc blocat, apoi anulat automat, și un client convins că are rezervare. Un transportator afișat, dar imposibil de emis, înseamnă rambursare, scuze și un client care nu se mai întoarce. Un ADM pentru o regulă tarifară încălcată de ruta furnizorului ajunge la cel care deține biletul — asigură-te dinainte dacă acela ești tu.

Apoi vine costul schimbării. Fiecare ciudățenie a furnizorului pe care o absorbi — un cod de stare care înseamnă două lucruri, un câmp care uneori e string — ajunge în modelul tău de date. După doi ani, alegerea API-ului nu mai e o integrare pe care o înlocuiești într-un sprint; e forma tabelului tău de rezervări. Acesta e motivul real pentru a compara cu grijă acum.

Unde se încadrează propriul nostru API

Oferim API-uri pentru zboruri și hoteluri. Accesul începe cu o discuție, nu cu o cheie self-service, lucru pe care unii dezvoltatori îl găsesc lent; motivul e că în acea discuție întrebările de mai sus se pun în ambele sensuri — de ce rute și orașe ai nevoie, ce conținut vei putea efectiv emite sau confirma și cine se ocupă de ce după rezervare. Dacă faci o comparație, adu lista asta cu tine. Pagina despre API-urile de turism e locul unde începe discuția.

Orice ai alege, alege din jurnalul perioadei de probă, nu din prezentare. Prezentarea îți spune ce vrea să fie un furnizor. Căile de eroare îți spun ce este.

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.