Zum Inhalt springen
Blog

Reise-API-Sandbox-Tests: was die Sandbox Ihnen verschweigt

Tekravel Redaktion
Mit Unterstützung von KI geschrieben

Die Integration hat alles bestanden, was Reise-API-Sandbox-Tests ihr entgegenwerfen konnten. Die Suche lieferte Flüge, die Hotelverfügbarkeit lieferte Zimmer, der Buchungsaufruf gab jedes Mal eine Bestätigungsnummer zurück, und die QA gab an einem Donnerstag frei. Am Dienstag darauf bezahlte ein Kunde ein Hotel zu einem Preis, den der Lieferant zu einem anderen bestätigte; eine Flugbuchung lief in einen Timeout, und niemand konnte sagen, ob der Sitz gehalten wurde; eine Support-Mitarbeiterin verbrachte den Nachmittag damit, zwei Datensätze abzugleichen, die dieselbe Reise beschrieben. Nichts davon war ein Bug, den die Testsuite übersehen hatte. Es waren Szenarien, die sie gar nicht sehen konnte. Die Sandbox ist notwendig, aber weit davon entfernt, ausreichend zu sein – und in der Lücke dazwischen passieren die meisten teuren Vorfälle einer Reiseintegration.

Dies ist ein Testplan für den Entwickler, der diese Integration verantwortet: was eine Sandbox beweisen kann, was sie strukturell nicht kann und wie man die Differenz abdeckt, ohne echte Sitze auf die Firmenkarte zu buchen.

Warum Reise-API-Sandbox-Tests Code durchwinken, den die Produktion bricht

Eine Sandbox ist ein Versprechen über die Form der Antworten, nicht über ihr Verhalten. Das Schema entspricht der Produktion. Das Verhalten fast nie – und daran ist niemand schuld: Eine Testumgebung kann sich kein Live-Inventar leisten, also liefert sie einen festen Satz an Tarifen und Zimmern, die nie ausverkauft sind, nie den Preis ändern und nie den Flugplan. Sie antwortet schnell, weil sonst niemand sie nutzt. Und sie scheitert selten auf halbem Weg.

Die Produktion tut all das täglich. Das Inventar teilt man mit jedem anderen Verkäufer; Tarife werden irgendwo vorgelagert gecacht und veralten; das System eines Lieferanten antwortet unter Last langsam oder gar nicht. Code, der nur die Sandbox kennt, wurde praktisch nur gegen einen Lieferanten getestet, der einen perfekten Tag hat.

Behandeln Sie die Sandbox deshalb als eine von drei Schichten. Sie beweist, dass Ihre Requests korrekt sind und Ihr Parser das Schema versteht. Aufgezeichnete Fixtures beweisen, dass Ihr Code die Antworten übersteht, die die Produktion wirklich schickt. Ein kleiner, bewusst gewählter Satz von Live-Checks beweist die Verdrahtung, nachdem sich etwas geändert hat. Jede Schicht fängt, was die anderen beiden nicht sehen.

Szenarien, die eine Sandbox meist nicht liefert

Schreiben Sie diese auf, bevor Sie den ersten Test schreiben. Eine Sandbox simuliert vielleicht ein oder zwei davon mit einem magischen Testwert; die meisten hat sie schlicht nicht.

SzenarioWas die Produktion tutWie man es abdeckt
Preisänderung zwischen Suche und BuchungDie Buchung gelingt mit anderem Gesamtpreis oder scheitert mit einem Preisänderungsfehler, den Sie anzeigen müssenFixture-Paar: Suchantwort und Buchungsantwort mit abweichendem Gesamtpreis; prüfen, dass der Reisende erneut gefragt und nie stillschweigend belastet wird
Ausgebucht zwischen Verfügbarkeit und BuchungDas angebotene Zimmer oder die Buchungsklasse ist beim Halten wegFixture des echten Ausgebucht-Fehlers des Lieferanten; prüfen, dass der Reisende zu den Ergebnissen zurückkehrt, nicht auf eine Fehlerseite
Timeout beim BuchungsaufrufDer Lieferant hat die Buchung vielleicht angelegt, vielleicht nichtTimeout nach dem Senden injizieren; prüfen, dass der Buchungsstatus abgefragt wird, bevor irgendetwas wiederholt
Doppelte ÜbermittlungEin Doppelklick oder ein Client-Retry erzeugt zwei BuchungenDieselbe Buchung zweimal mit demselben Idempotency-Key senden; prüfen, dass genau eine existiert
Flugplanänderung nach TicketausstellungDer verkaufte Flug startet zu anderer Zeit oder unter anderer FlugnummerFixture einer geänderten Reiseroute; prüfen, dass die Änderung den erreicht, der den Kunden betreut
Teilerfolg bei einer KombibuchungDer Flug ist bestätigt, das Hotel nichtGemischte Fixture; prüfen, dass das System genau festhält, was bestätigt ist, und einen Menschen alarmiert
Drosselung unter LastRate-Limit-Antworten, danach langsame AntwortenAufgezeichnete Drosselungsantwort abspielen; Backoff prüfen und dass die Suche degradiert statt zu scheitern

Über die letzte Spalte kann man für den eigenen Stack streiten. Gut so. Entscheidend ist, dass jede Zeile einen Verantwortlichen und eine Assertion hat, denn jede davon wird Ihnen irgendwann passieren.

Fixtures aus echten Antworten bauen, nicht aus erfundenen

Die nützlichste Gewohnheit in einer Reiseintegration: Antworten aufheben, die Sie überrascht haben. Handgeschriebene Mock-Daten spiegeln, was Sie glauben, dass ein Lieferant schickt; eine aufgezeichnete Antwort spiegelt, was er tatsächlich geschickt hat – inklusive der Felder, die laut Dokumentation nie leer sind und es doch sind, des Preises in einer Währung, die Sie nicht angefragt haben, und des Fehlers, der mit einem Erfolgsstatus ankommt.

Eine Routine, die funktioniert:

  • An der Grenze aufzeichnen. Rohe Request- und Response-Bodies der Lieferantenaufrufe außerhalb der Produktion loggen, in der Produktion für eine Stichprobe des Traffics, sofern Ihre Datenschutzregeln das erlauben.
  • Bereinigen, bevor man aufbewahrt. Passagiernamen, Passnummern, E-Mails, Telefonnummern und Zahlungsreferenzen fliegen raus, bevor eine Fixture ins Repository kommt. Ersetzen Sie sie durch offensichtlich falsche Werte, damit niemand eine Fixture für eine echte Buchung hält.
  • Nach Verhalten benennen. hotel-book-price-increased.json sagt dem nächsten Entwickler, warum die Datei existiert; response-17.json nicht.
  • Die hässlichen für immer behalten. Die kaputte Antwort, die an einem Sonntag die Suche lahmgelegt hat, ist die wertvollste Datei, die Sie besitzen. Sie gehört in einen Test, der bei jedem Commit läuft.

Dann schreiben Sie Contract-Tests gegen diese Fixtures: Parser, Mapping auf interne Modelle, Fehlerklassifikation. Benennt ein Lieferant ein Feld um und ein Contract-Test schlägt fehl, erfahren Sie es in der CI statt von einem Kunden. Die Klassifikationsseite behandeln wir ausführlicher in unserem Beitrag zur Fehlerbehandlung in Buchungs-APIs.

Geldflüsse testen, ohne Geld auszugeben

Hier hilft die Sandbox am wenigsten, denn die Geldflüsse sind genau der Ort, an dem sich eine Testumgebung von der echten unterscheidet. Echte Ticketausstellung, echte Kartenbelastung und echte Lieferantenabrechnung müssen am dringendsten stimmen und lassen sich am wenigsten live proben.

Teilen Sie das Problem. Preisberechnung ist reine Logik und offline vollständig testbar: aufgezeichnete Tarife nehmen, Ihre Markup-Regeln, Währungsumrechnung und Rundung anwenden, den Gesamtpreis prüfen, den der Reisende sieht. Machen Sie das für die unangenehmen Fälle – ein Tarif in USD, verkauft in EUR; ein Markup, das bei einem Produkt prozentual und beim anderen ein Festbetrag ist; ein Kindertarif; ein Rundungsschritt, der zwischen Anzeige und Belastung abweicht. Ein Gesamtpreis, der um ein paar Cent falsch ist, ist trotzdem falsch – und zwar bei jeder Buchung.

Die zweite Hälfte sind die Zustandsübergänge rund um die Zahlung. Modellieren Sie sie explizit – angeboten, gehalten, bezahlt, bestätigt, ausgestellt, storniert, erstattet – und testen Sie, dass jeder Übergang genau eine Ursache hat. Der Test, der den teuersten Bug fängt, prüft, dass keine Zahlung für eine vom Lieferanten unbestätigte Buchung eingezogen werden kann und dass keine bestätigte Buchung ohne Zahlungsdatensatz existiert.

Schließlich: Machen Sie es unmöglich, dass ein Testlauf die echte Ticketausstellung erreicht. Nicht unwahrscheinlich – unmöglich. Ein Startcheck, der die Suite verweigert, sobald Produktions-Credentials geladen sind, kostet eine Zeile und verhindert den schlimmsten Morgen, den ein Integrationsteam haben kann.

Was ein Fehler hier kostet

Ein übersehenes Szenario in einer Reiseintegration zeigt sich selten als Fehler. Es zeigt sich als Buchung, die gut aussieht. Ein doppeltes Ticket, das niemand bestellt hat und das jemand vor Fristende voiden muss. Ein Hotel, bestätigt zu einem Preis, den das Reisebüro jetzt schlucken muss. Eine Buchung im Timeout, die das System wiederholt hat – der Lieferant hält zwei Zimmer und berechnet beide. Bei einem über ein Reisebüro verkauften Flugticket kann eine Abweichung zwischen Ausgestelltem und Verkauftem später als ADM zurückkommen, lange nachdem die Marge aus dem Verkauf ausgegeben ist.

Diese Kosten landen bei dem Unternehmen, das die Reise verkauft hat, nicht bei dem Entwickler, der die Retry-Schleife geschrieben hat. Das ist das ganze Argument dafür, sie vor dem Launch zu testen, statt sie Support-Ticket für Support-Ticket zu lernen.

Smoke-Tests nach jeder Lieferantenänderung

Lieferanten ändern Dinge: eine neue API-Version, ein neuer Endpunkt, rotierte Zugangsdaten, ein anderes Content-Mapping. Ihr eigener Code hat sich vielleicht gar nicht geändert. Fahren Sie die Liste trotzdem, in der Umgebung, die mit dem geänderten Lieferanten spricht:

  1. Eine Suche pro Produkt, das Sie über diesen Lieferanten verkaufen, auf einer Strecke oder in einer Stadt, die bekanntermaßen Ergebnisse liefert, etwa Frankfurt–Dubai.
  2. Alle Ergebnisse parsen, ohne stillschweigend welche zu verwerfen; die eigene Anzahl mit der Rohantwort vergleichen.
  3. Ein Ergebnis von Anfang bis Ende bepreisen und den angezeigten Gesamtpreis mit der eigenen Rechnung aus dem Rohtarif vergleichen.
  4. In der Testumgebung buchen, den Status zurücklesen und jedes gespeicherte Feld vergleichen.
  5. Stornieren und prüfen, dass die Stornierung in Ihren Daten und beim Lieferanten sichtbar ist.
  6. Die gesammelten hässlichen Fixtures durch den neuen Parser schicken.
  7. Prüfen, dass Timeouts und Rate-Limits weiterhin auf das von Ihnen festgelegte Verhalten führen, denn eine neue Version beantwortet sie womöglich anders. Haben sich die Antwortzeiten verschoben, erklärt unser Beitrag zur Latenz, welcher Teil davon in Ihrer Hand liegt.

Kurz genug, um sie jedes Mal laufen zu lassen – genau darum geht es. Ein Smoke-Test, den keiner fährt, weil er einen Tag dauert, ist keiner.

Wo die Sandbox hingehört

Nichts davon macht die Sandbox weniger nützlich. Es macht sie ehrlich: der Ort, an dem man das Schema lernt und bestätigt, dass die Requests stimmen, bevor Fixtures und Live-Checks die Teile übernehmen, die sie nicht erreicht. Wenn Sie die Flug- und Hotel-APIs der Plattform evaluieren: Der Zugang beginnt mit einem Gespräch, nicht mit einem Self-Service-Key – bringen Sie diesen Testplan in dieses Gespräch mit und fragen Sie, wie jede Zeile der Tabelle oben abgedeckt würde. Die Antworten verraten Ihnen über eine API mehr als ihre Dokumentation.

Tekravel Redaktion

Ressort Reisetechnologie

Das Ressort Reisetechnologie von Tekravel schreibt für die Branche: Agenturinhaber, Konsolidatoren und die Entwickler, die sie anbinden. Jeder Artikel wird vor der Veröffentlichung an der beschriebenen Plattform überprüft.