Przejdź do treści
Blog

Testowanie API turystycznego w sandboksie: czego nie pokaże

Redakcja Tekravel
Napisano z pomocą AI

Integracja przeszła wszystko, czym mogło ją sprawdzić testowanie API turystycznego w sandboksie. Wyszukiwanie zwracało loty, zapytanie o dostępność hoteli wracało z wolnymi pokojami, wywołanie rezerwacji za każdym razem oddawało numer potwierdzenia, a QA zatwierdził wszystko w czwartek. We wtorek klient zapłacił za hotel jedną cenę, a dostawca potwierdził go w innej, rezerwacja lotu skończyła się timeoutem i nikt nie umiał powiedzieć, czy miejsce zostało zablokowane, a konsultant supportu spędził popołudnie na uzgadnianiu dwóch rekordów opisujących tę samą podróż. Żadna z tych rzeczy nie była błędem, który przeoczył zestaw testów. To były scenariusze, których zestaw testów w ogóle nie miał jak zobaczyć. Sandbox jest konieczny, ale daleko mu do wystarczającego, a w luce między jednym a drugim mieszka większość kosztownych incydentów integracji turystycznej.

To plan testów dla developera, który odpowiada za tę integrację: co sandbox może udowodnić, czego z natury rzeczy nie może i jak pokryć różnicę bez rezerwowania prawdziwych miejsc na firmową kartę.

Dlaczego kod, który przechodzi w sandboksie, psuje się na produkcji

Sandbox to obietnica dotycząca kształtu odpowiedzi, nie ich zachowania. Schemat zgadza się z produkcją. Zachowanie prawie nigdy, z powodów, za które nikt nie odpowiada: środowiska testowego nie stać na żywe inwentarze, więc serwuje stały zestaw taryf i pokoi, które nigdy się nie wyprzedają, nigdy nie zmieniają ceny i nigdy nie zmieniają rozkładu. Odpowiada szybko, bo nikt inny z niego nie korzysta. Rzadko pada w połowie.

Produkcja robi to wszystko codziennie. Inwentarz jest współdzielony z każdym innym sprzedawcą; taryfy ktoś wyżej trzyma w cache i się starzeją; system dostawcy pod obciążeniem odpowiada wolno albo wcale. Kod, który widział tylko sandbox, był w praktyce testowany wyłącznie na dostawcy mającym idealny dzień.

Traktuj więc sandbox jako jedną z trzech warstw. Dowodzi, że żądania są poprawnie zbudowane, a parser rozumie schemat. Nagrane fixtures dowodzą, że kod przetrwa odpowiedzi, które produkcja naprawdę wysyła. Mały, przemyślany zestaw testów na żywo dowodzi, że połączenia działają po każdej zmianie. Każda warstwa łapie to, czego nie złapią dwie pozostałe.

Scenariusze, których sandbox zwykle nie daje

Spisz je, zanim napiszesz pierwszy test. Sandbox może zasymulować jeden czy dwa za pomocą magicznej wartości testowej; większości po prostu nie ma.

ScenariuszCo robi produkcjaJak to pokryć
Cena zmienia się między wyszukaniem a rezerwacjąRezerwacja przechodzi z inną sumą albo kończy się błędem zmiany ceny, który trzeba pokazaćPara fixtures: odpowiedź wyszukiwania i odpowiedź rezerwacji z inną sumą; sprawdź, że podróżny zostaje zapytany ponownie, a nie obciążony po cichu
Wyprzedane między dostępnością a rezerwacjąOferowany pokój lub klasa taryfowa znika, gdy próbujesz go zablokowaćFixture prawdziwego błędu „wyprzedane” od dostawcy; sprawdź, że podróżny wraca do wyników, a nie na stronę błędu
Timeout przy wywołaniu rezerwacjiDostawca mógł utworzyć rezerwację albo nieWstrzyknij timeout po wysłaniu żądania; sprawdź, że pytasz o status rezerwacji, zanim cokolwiek ponowi próbę
Podwójne wysłaniePodwójne kliknięcie lub retry klienta tworzy dwie rezerwacjeWyślij tę samą rezerwację dwa razy z tym samym idempotency key; sprawdź, że istnieje dokładnie jedna
Zmiana rozkładu po wystawieniu biletuSprzedany lot wylatuje teraz o innej godzinie albo pod innym numeremFixture zmienionego planu podróży; sprawdź, że zmiana trafia do osoby, która prowadzi klienta
Częściowy sukces przy rezerwacji kilku usługLot się potwierdza, hotel nieMieszana fixture; sprawdź, że system zapisuje dokładnie to, co potwierdzono, i alarmuje człowieka
Throttling pod obciążeniemOdpowiedzi rate limit, potem wolne odpowiedziOdtwórz nagraną odpowiedź throttlingu; sprawdź backoff i to, że wyszukiwanie degraduje się zamiast zwracać błąd

Możesz nie zgadzać się z ostatnią kolumną w kontekście swojego stosu. W porządku. Liczy się to, żeby każdy wiersz miał właściciela i asercję, bo każdy z nich w końcu ci się przydarzy.

Buduj fixtures z prawdziwych odpowiedzi, nie wymyślonych

Najbardziej przydatny nawyk w integracji turystycznej to zachowywanie odpowiedzi, które cię zaskoczyły. Ręcznie pisane mocki odzwierciedlają to, co ci się wydaje, że dostawca wysyła; nagrana odpowiedź odzwierciedla to, co naprawdę wysłał — łącznie z polami pustymi, choć dokumentacja twierdzi, że nigdy takie nie są, ceną w walucie, o którą nie prosiłeś, i błędem, który przychodzi ze statusem sukcesu.

Rutyna, która działa:

  • Nagrywaj na granicy. Loguj surowe ciała żądań i odpowiedzi wywołań dostawców w środowisku nieprodukcyjnym, a na produkcji dla próbki ruchu, jeśli pozwalają na to twoje zasady prywatności.
  • Czyść, zanim zachowasz. Nazwiska pasażerów, numery paszportów, e-maile, telefony i referencje płatności wylatują, zanim fixture trafi do repozytorium. Zastąp je oczywiście fałszywymi wartościami, żeby nikt nie wziął fixture za prawdziwą rezerwację.
  • Nazywaj fixtures od zachowania. hotel-book-price-increased.json mówi następnemu developerowi, po co istnieje; response-17.json nie mówi nic.
  • Brzydkie trzymaj na zawsze. Zniekształcona odpowiedź, która w jakąś niedzielę położyła wyszukiwanie, to najcenniejszy plik, jaki masz. Jej miejsce jest w teście uruchamianym przy każdym commicie.

Potem napisz testy kontraktowe na tych fixtures: parser, mapowanie na modele wewnętrzne, klasyfikację błędów. Jeśli dostawca zmieni nazwę pola i test kontraktowy padnie, dowiesz się o tym w CI, a nie od klienta. Klasyfikację omawiamy szerzej w tekście o obsłudze błędów w API silnika rezerwacji.

Testowanie ścieżek pieniędzy bez wydawania pieniędzy

Tu sandbox pomaga najmniej, bo ścieżki pieniędzy to dokładnie to miejsce, w którym środowisko testowe różni się od prawdziwego. Prawdziwe wystawianie biletów, prawdziwe obciążenie karty i prawdziwe fakturowanie przez dostawcę to rzeczy, które najbardziej musisz zrobić dobrze i których najmniej możesz przećwiczyć na żywo.

Podziel problem. Matematyka cen to czysta logika i można ją przetestować wyczerpująco offline: weź nagrane taryfy, zastosuj reguły marży, przeliczenie walut i zaokrąglenia, i sprawdź sumę, którą widzi podróżny. Zrób to dla niewygodnych przypadków — taryfa w jednej walucie sprzedawana w innej, marża procentowa na jednym produkcie i kwotowa na drugim, taryfa dziecięca, zaokrąglenie, które różni się między wyświetleniem a obciążeniem. Suma błędna o kilka złotych nadal jest błędna, i to przy każdej rezerwacji.

Druga połowa to przejścia stanów wokół płatności. Zamodeluj je jawnie — wyceniona, zablokowana, opłacona, potwierdzona, wystawiona, anulowana, zwrócona — i przetestuj, że każde przejście ma dokładnie jedną przyczynę. Test, który łapie najdroższy błąd, to ten, który sprawdza, że nie da się pobrać płatności za rezerwację niepotwierdzoną przez dostawcę i że potwierdzona rezerwacja nie może istnieć bez rekordu płatności.

Na koniec spraw, żeby przebieg testów nie mógł dotrzeć do prawdziwego wystawiania biletów. Nie mało prawdopodobne; niemożliwe. Kontrola przy starcie, która odmawia uruchomienia zestawu, gdy załadowane są produkcyjne dane dostępowe, kosztuje jedną linijkę i zapobiega najgorszemu porankowi, jaki może mieć zespół integracji.

Ile kosztuje pomyłka

Przeoczony scenariusz w integracji turystycznej rzadko objawia się jako błąd. Objawia się jako rezerwacja, która wygląda dobrze. Zduplikowany bilet, o który nikt nie prosił i który ktoś musi unieważnić przed terminem. Hotel potwierdzony w cenie, którą agencja musi teraz pokryć z własnej kieszeni. Rezerwacja z timeoutem, którą system ponowił, więc dostawca trzyma dwa pokoje i fakturuje oba. Przy bilecie lotniczym sprzedanym przez agencję rozbieżność między tym, co wystawiono, a tym, co sprzedano, może wrócić później jako ADM — długo po tym, jak marża z tej sprzedaży została wydana.

Te koszty spadają na firmę, która sprzedała podróż, a nie na developera, który napisał pętlę retry. To cały argument za testowaniem ich przed startem zamiast uczenia się ich po jednym zgłoszeniu do supportu.

Co sprawdzić smoke testem po każdej zmianie u dostawcy

Dostawcy zmieniają różne rzeczy: nową wersję API, nowy endpoint, zrotowane dane dostępowe, inne mapowanie treści. Twój kod mógł się w ogóle nie zmienić. Uruchom tę listę mimo to, w środowisku, które rozmawia ze zmienionym dostawcą:

  1. Jedno wyszukiwanie na każdy produkt, który sprzedajesz od tego dostawcy, na trasie lub w mieście, o którym wiesz, że zwraca wyniki.
  2. Sparsuj każdy wynik, nie gubiąc żadnego po cichu; porównaj swoją liczbę z tym, co zawiera surowa odpowiedź.
  3. Wyceń jeden wynik od początku do końca i porównaj wyświetloną sumę z własnym wyliczeniem z surowej taryfy.
  4. Zrób rezerwację w środowisku testowym, odczytaj jej status i porównaj każde pole, które zapisujesz.
  5. Anuluj ją i potwierdź, że anulacja jest widoczna zarówno w twoich rekordach, jak i po stronie dostawcy.
  6. Przepuść zachowane brzydkie fixtures przez nowy parser.
  7. Sprawdź, czy timeouty i rate limity nadal prowadzą do zachowania, na które się zdecydowałeś, bo nowa wersja może odpowiadać na nie inaczej. Jeśli czasy odpowiedzi się przesunęły, tekst o opóźnieniach wyjaśnia, którą część możesz naprawić sam.

Na tyle krótka, żeby uruchamiać ją za każdym razem — i o to chodzi. Smoke test, którego nikt nie uruchamia, bo zajmuje dzień, nie jest smoke testem.

Gdzie jest miejsce sandboksa

Nic z tego nie czyni sandboksa mniej użytecznym. Czyni go uczciwym: to miejsce, w którym poznajesz schemat i potwierdzasz, że żądania są poprawne, zanim fixtures i testy na żywo przejmą części, do których on nie sięga. Jeśli oceniasz API lotów i hoteli tej platformy, dostęp zaczyna się od rozmowy, a nie od klucza self-service — przynieś ten plan testów na tę rozmowę i zapytaj, jak zostałby pokryty każdy wiersz powyższej tabeli. Odpowiedzi powiedzą ci o API więcej niż jego dokumentacja.

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.