Przejdź do treści
Blog

Porównanie API turystycznych: oceniaj osie, nie dostawców

Redakcja Tekravel
Napisano z pomocą AI

Masz otwarte trzy prezentacje dostawców w trzech kartach. Każda ma slajd z długą listą linii lotniczych, slajd z liczbą hoteli, sandbox, REST i JSON oraz adres e-mail wsparcia. Budujesz arkusz, stawiasz ptaszek w każdej komórce i arkusz kończy się remisem. Tak zwykle kończy się porównanie API turystycznych robione jako lista funkcji — i to jest zły koniec, bo różnice, które zdecydują o twoim następnym roku, wychodzą dopiero po starcie produkcyjnym: przy rezerwacji, która u dostawcy się udała, a po twojej stronie skończyła się timeoutem, przy zwrocie, którego nikt nie umie przeprocesować, przy linii, która była na liście, ale tą drogą nie da się wystawić na nią biletu.

Ten tekst jest dla programisty albo lidera technicznego, który musi podjąć tę decyzję i bronić jej później. Nie robi rankingu dostawców. Daje osie porównania, plan okresu testowego, który poświęca czas na awarie, i krótki zestaw pytań, które szybko pokażą, czy rozmawiasz z dostawcą, czy z odsprzedawcą cudzego dostawcy.

Dlaczego lista funkcji zawsze kończy się remisem

Lista funkcji pyta, czy dana możliwość istnieje. Prawie każde API turystyczne odpowie „tak” na prawie każdy wiersz, bo wiersze są pisane na poziomie strony marketingowej: wyszukiwanie, wycena, rezerwacja, anulowanie, wystawienie biletu, webhooki, sandbox. Pytanie, które je odróżnia, nie brzmi, czy cancel istnieje, tylko co się dzieje, gdy wywołasz je na rezerwacji z wystawionym biletem dwanaście godzin przed wylotem, na taryfie z karą, przez drogę, w której treść przyszła od strony trzeciej. Lista funkcji nie ma na to kolumny.

Jest i drugi problem. Listę wypełnia zwykle sam dostawca. Oceniasz jego autoprezentację.

Porównanie API turystycznych oparte na osiach, nie na dostawcach

Zastąp siatkę dostawca-na-funkcję osiami, które oceniasz sam, na podstawie dowodów zebranych w okresie testowym. Poniższa tabela to ta, której użylibyśmy my. Możesz inaczej rozłożyć wagi — firma sprzedająca wyłącznie hotele mniej dba o wystawianie biletów — i warto się z nią pospierać, zanim ją przyjmiesz.

OśO co pyta lista funkcjiCzego naprawdę się dowiedziećJak brzmi słaba odpowiedź
ZasięgIle linii i hoteli?Ile da się wyszukać, zarezerwować ORAZ wystawić lub potwierdzić przez to API na twoich rynkachJedna duża liczba bez podziału
GłębokośćCzy jest endpoint anulowania?Które działania po rezerwacji są zautomatyzowane dla każdego źródła treści: void, zwrot, reissue, korekta nazwiska, usługi dodatkowe„Tym zajmuje się nasz dział operacji”
Wiarygodność cenyCzy cena jest w czasie rzeczywistym?Jak często cena przy rezerwacji różni się od ceny z wyszukiwania i jak API ci o tym mówi„Ceny są zawsze aktualne”
Semantyka błędówCzy błędy są udokumentowane?Czy błąd mówi, w jakim stanie jest rezerwacja, a nie tylko że coś się nie udałoJeden ogólny kod na każdą awarię
Idempotencja—Czy ponowione wywołanie rezerwacji może utworzyć drugą rezerwacjęCisza, a potem „nie spotkaliśmy się z tym”
Dostawca umowny—Czyja umowa, czyj numer IATA, czyj BSP obsługuje bilet„Pracujemy ze wszystkimi dużymi GDS”
Dostęp i wsparcieCzy jest sandbox?Kto odpowiada, gdy prawdziwy PNR utknie, i jak szybkoFormularz zgłoszeń i żadnej osoby z imienia i nazwiska

Dwa z tych wierszy nie mają w ogóle pytania na liście funkcji. To nie przypadek: to wiersze, które kosztują najwięcej, gdy coś pójdzie źle, i te, o których prezentacja handlowa najrzadziej wspomni sama z siebie.

Zasięg to nie głębokość

Lista linii lotniczych to najbardziej mylący slajd w każdej prezentacji. Lista kilkuset przewoźników może znaczyć kilka różnych rzeczy, a tylko jedna z nich jest tym, czego szukasz.

Część tych przewoźników przychodzi przez GDS i da się ich zarezerwować i wystawić od początku do końca. Część przychodzi przez połączenia NDC, gdzie wyszukiwanie może działać dobrze, ale obsługa po rezerwacji — zmiany, częściowe zwroty, dokupienie bagażu — u tej linii wciąż bywa ręczna. Część to tanie linie, których treść jest agregowana od innego odsprzedawcy: możesz je pokazać, czasem zarezerwować, a potem bilet przychodzi drogą, której nie kontrolujesz, w terminie, którego nie możesz obiecać klientowi. A niektóre są na liście, bo kiedyś jakaś taryfa pojawiła się w odpowiedzi wyszukiwania.

Przewoźnik, którego możesz pokazać, ale nie możesz wystawić, to nie zasięg. Dla produktu detalicznego to gorzej niż brak, bo klient go wybiera, płaci i czeka.

Hotele mają ten sam kształt, tylko inne słowa. Liczba obiektów obejmuje te, które dostawca zmapował, i te, których nie zmapował; statyczne stawki zapisane w cache w zeszłym tygodniu obok dostępności na żywo; pokoje w allotmencie z okresem release obok puli w free sale. Poproś o liczbę obiektów rezerwowalnych na żywo w miastach, w których sprzedajesz, i zapytaj, jak scalane są duplikaty między ich własnymi dostawcami — ten sam hotel pokazany trzy razy w trzech cenach to zgłoszenie do supportu, które tylko czeka.

Test praktyczny jest wąski. Spisz dwadzieścia tras i dwadzieścia miast hotelowych, które robią większość twojego wolumenu — powiedzmy Warszawa–Dubaj, Katowice–Antalya, hotele w Dubaju i w Hurghadzie — i poproś dostawcę, żeby pokazał właśnie je działające od początku do końca w sandboksie: wyszukiwanie, wycena, rezerwacja, wystawienie lub potwierdzenie, anulowanie. Dostawca, który ma głębokość, zrobi to bez ceregieli. Dostawca, który ma slajd, zacznie mówić o slajdzie.

Co testować w okresie testowym: ścieżki błędów, nie szczęśliwe ścieżki

Każdy sandbox z powodzeniem rezerwuje bilet w jedną stronę w ekonomicznej na spokojnej trasie. Po to go zbudowano. Twój ruch produkcyjny spędzi znaczną część życia na pozostałych ścieżkach, a okres testowy to jedyny tani moment, żeby je zobaczyć.

Przejdź w nim tę listę i zapisuj, co zwróciło API, obok tego, co faktycznie okazało się prawdą potem:

  • Zmiana ceny między wyszukiwaniem a rezerwacją. Czy wywołanie rezerwacji kończy się błędem, przechodzi po nowej cenie, czy zwraca osobną odpowiedź z prośbą o potwierdzenie? Czy twój interfejs odróżni te przypadki bez parsowania tekstu komunikatu?
  • Wygasła oferta. Wyszukaj, odczekaj dłużej niż deklarowany przez dostawcę czas życia oferty, potem rezerwuj. Czy wygaśnięcie to osobny błąd, czy ten sam, co „dostawca niedostępny”?
  • Wyprzedane przy rezerwacji. Dostępność, która znika między wyceną a rezerwacją. W jakim stanie jest rezerwacja i czy blokada płatności zostaje zwolniona?
  • Ponowienie po timeoucie. Wyślij żądanie rezerwacji, zerwij połączenie przed odpowiedzią i wyślij je jeszcze raz. Masz teraz jeden PNR czy dwa? Ten jeden test powie ci o dostawcy więcej niż cała reszta okresu testowego razem.
  • Rezerwacja utworzona, wystawienie nieudane. Czy API umie zgłosić PNR, który istnieje, ale nie ma biletu, i czy podaje termin wystawienia?
  • Częściowa awaria. Zapytanie hotelowe o kilka pokoi, w którym jeden się potwierdza, a drugi nie. Podróż w obie strony, w której odcinki pochodzą z różnych źródeł.
  • Anulowanie poza bezpłatnym oknem. Czy kara jest podana przed potwierdzeniem, czy odkrywasz ją na fakturze?
  • Awaria dostawcy. Zapytaj dostawcę, jak ją zasymulować. Jeśli nie wie, zapytaj, jak jego klienci dowiedzieli się, jak system się wtedy zachowuje.

W każdym przypadku oceniasz dwie rzeczy. Po pierwsze: czy API mówi prawdę o stanie rezerwacji? Po drugie: czy twój kod może na tej podstawie działać bez człowieka czytającego wolny tekst? Z API, które zawodzi jasno, łatwiej się żyje niż z takim, które udaje się niejednoznacznie.

O stronie lotniczej pisaliśmy szerzej w tym, czego dokumentacja API rezerwacji lotów nie mówi, a o projektowaniu klienta dla wolnych dostawców hotelowych w tekście o dostępności hoteli. Oba dobrze uzupełniają plan okresu testowego.

Pytania, które demaskują płytkiego agregatora

Nie ma nic złego w agregatorze. Większość treści turystycznych dociera do większości sprzedawców właśnie przez któregoś z nich. Ryzykiem jest agregator płytki: warstwa, która odsprzedaje API innej warstwy, dokłada marżę i nie ma ani umowy z dostawcą, ani własnego działu operacji. Gdy coś się psuje, odpowiedź musi przejść dwie firmy w górę i z powrotem.

Pięć pytań szybko to wydobywa:

  1. Kto jest dostawcą umownym tej rezerwacji? Na czyjej umowie z linią lub hotelem się opiera?
  2. Przez czyj numer IATA i czyj BSP idzie bilet? Jeśli odpowiedź brzmi „partnera”, zapytaj, kto dostaje ADM, gdy złamana zostanie reguła taryfowa.
  3. Co dzieje się po waszej stronie, gdy wywołuję cancel? Automatyczne wywołanie u dostawcy czy kolejka, którą ktoś podejmie?
  4. Czy mogę zobaczyć błąd źródłowy? Płytka warstwa zwykle spłaszcza każdą awarię do jednego kodu, bo nie do końca rozumie błędy, które dostaje.
  5. Do kogo dzwonię w sprawie utkniętej rezerwacji na żywo i do kogo dzwonią oni? Policz przeskoki.

Żadna z tych odpowiedzi sama w sobie nie dyskwalifikuje. Numer IATA partnera może być w porządku, jeśli umowa jasno mówi, kto ponosi notę debetową. Liczy się to, czy dostawca odpowiada precyzyjnie i szybko. Mgliste odpowiedzi dziś to te, które dostaniesz później, na produkcji, o gorszej porze.

Ile kosztuje zła decyzja

Integracja to tania część. Drogie przychodzą później i nie ma ich w żadnym kosztorysie.

Błąd z podwójną rezerwacją to klient obciążony dwa razy i PNR, który trzeba znaleźć i anulować ręcznie, być może już po zamknięciu bezpłatnego okna void. Rezerwacja, która udała się u źródła, gdy twoja strona zapisała błąd, to zablokowane miejsce, potem automatyczne anulowanie i klient przekonany, że ma rezerwację. Przewoźnik pokazany, a niemożliwy do wystawienia, to zwrot, przeprosiny i klient, który nie wraca. ADM za regułę taryfową złamaną przez drogę dostawcy trafia do właściciela biletu — upewnij się z góry, czy to ty.

Do tego dochodzi koszt zmiany. Każde dziwactwo dostawcy, które wchłaniasz — kod statusu znaczący dwie rzeczy, pole, które czasem jest stringiem — ląduje w twoim modelu danych. Po dwóch latach wybór API nie jest już integracją, którą wymienisz w jednym sprincie; to kształt twojej tabeli rezerwacji. To jest prawdziwy powód, żeby porównywać starannie teraz.

Jak nasze API wpisuje się w tę metodę

Udostępniamy API lotnicze i hotelowe. Dostęp zaczyna się od rozmowy, a nie od klucza w trybie self-service, co niektórym programistom wydaje się powolne; powód jest taki, że w tej rozmowie powyższe pytania padają w obie strony — jakich tras i miast potrzebujesz, jaką treść faktycznie da się wystawić lub potwierdzić i kto za co odpowiada po rezerwacji. Jeśli robisz porównanie, przynieś tę listę. Strona z API turystycznymi to miejsce, gdzie ta rozmowa się zaczyna.

Cokolwiek wybierzesz, wybieraj na podstawie dziennika z okresu testowego, a nie prezentacji. Prezentacja mówi ci, kim dostawca chce być. Ścieżki błędów mówią, kim jest.

Redakcja Tekravel

Dział technologii turystycznych

Dział technologii turystycznych Tekravel pisze dla branży: właścicieli agencji, konsolidatorów i deweloperów, którzy ich integrują. Każdy artykuł jest przed publikacją sprawdzany na platformie, którą opisuje.