Zum Inhalt springen
Blog

Reise-API-Vergleich: Achsen bewerten, nicht Anbieter

Tekravel Redaktion
Mit Unterstützung von KI geschrieben

In drei Tabs sind drei Anbieterpräsentationen offen. Jede hat eine Folie mit einer langen Airline-Liste, eine Folie mit einer Hotelzahl, eine Sandbox, REST und JSON und eine Support-Adresse. Sie bauen eine Tabelle, setzen in jede Zelle einen Haken, und die Tabelle endet unentschieden. So endet ein Reise-API-Vergleich üblicherweise, wenn er als Feature-Checkliste geführt wird – und es ist das falsche Ende. Die Unterschiede, die über Ihr nächstes Jahr entscheiden, zeigen sich erst nach dem Go-live: bei der Buchung, die beim Lieferanten erfolgreich war, auf Ihrer Seite aber in einen Timeout lief; bei der Erstattung, die niemand abwickeln kann; bei der Airline, die auf der Liste stand, über diesen Weg aber nicht ticketiert werden kann.

Dieser Text richtet sich an Entwickler oder technische Leads, die diese Entscheidung treffen und später verteidigen müssen. Er bewertet keine Anbieter. Er liefert Vergleichsachsen, einen Testplan, der seine Zeit mit Fehlern verbringt, und ein paar Fragen, die schnell zeigen, ob Sie mit einem Lieferanten sprechen oder mit dem Wiederverkäufer eines fremden Lieferanten.

Warum die Feature-Checkliste immer unentschieden ausgeht

Eine Checkliste fragt, ob eine Fähigkeit existiert. Fast jede Reise-API kann fast jede Zeile bejahen, denn die Zeilen sind auf Ebene der Marketingseite formuliert: Suche, Pricing, Buchung, Storno, Ticketing, Webhooks, Sandbox. Was sie unterscheidet, ist nicht, ob es cancel gibt, sondern was passiert, wenn Sie es auf einer ticketierten Buchung zwölf Stunden vor Abflug aufrufen, auf einem Tarif mit Stornogebühr, über einen Weg, dessen Content von einem Dritten stammt. Dafür hat die Checkliste keine Spalte.

Dazu kommt ein zweites Problem. Ausgefüllt wird die Checkliste meist vom Anbieter selbst. Sie bewerten seine Selbstbeschreibung.

Ein Reise-API-Vergleich nach Achsen, nicht nach Anbietern

Ersetzen Sie das Raster Anbieter × Feature durch Achsen, die Sie selbst bewerten – anhand von Belegen, die Sie im Test gesammelt haben. Die Tabelle unten ist die, die wir verwenden würden. Sie können die Zeilen anders gewichten – ein reiner Hotelanbieter interessiert sich weniger fürs Ticketing –, und Sie sollten mit ihr streiten, bevor Sie sie übernehmen.

AchseWas die Checkliste fragtWas Sie tatsächlich herausfinden müssenWie eine schwache Antwort klingt
AbdeckungWie viele Airlines und Hotels?Wie viele davon sich in Ihren Märkten über diese API suchen, buchen UND ticketieren bzw. bestätigen lassenEine einzige große Zahl ohne Aufschlüsselung
TiefeGibt es einen Storno-Endpoint?Welche Aktionen nach der Buchung je Content-Quelle automatisiert sind: Void, Erstattung, Umbuchung, Namenskorrektur, Zusatzleistungen„Das macht unser Ops-Team“
PreistreueSind die Preise in Echtzeit?Wie oft der Buchungspreis vom Suchpreis abweicht und wie die API Ihnen das mitteilt„Die Preise sind immer live“
FehlersemantikSind Fehler dokumentiert?Ob ein Fehler den Zustand der Buchung nennt, nicht nur, dass etwas schiefgingEin generischer Code für jeden Fehler
Idempotenz—Ob ein wiederholter Buchungsaufruf eine zweite Buchung erzeugen kannSchweigen, dann „das haben wir noch nie gesehen“
Lieferant der Buchung—Wessen Vertrag, wessen IATA-Nummer, über welchen BSP das Ticket läuft„Wir arbeiten mit allen großen GDS“
Zugang und SupportGibt es eine Sandbox?Wer antwortet, wenn ein echter PNR hängt, und wie schnellEin Ticketformular, kein namentlicher Ansprechpartner

Zwei dieser Zeilen haben in einer üblichen Checkliste gar keine Entsprechung. Das ist kein Zufall: Es sind die Zeilen, die am teuersten werden, wenn sie schiefgehen, und die ein Anbieter-Deck am wenigsten von sich aus anspricht.

Abdeckung ist nicht Tiefe

Die Airline-Liste ist die irreführendste Folie jeder Präsentation. Eine Liste mit mehreren hundert Carriern kann Verschiedenes bedeuten, und nur eine Lesart ist die, die Sie wollen.

Manche dieser Carrier kommen über ein GDS und lassen sich durchgängig buchen und ticketieren. Manche kommen über NDC-Anbindungen, bei denen das Shopping gut funktionieren mag, das Servicing nach der Buchung – Umbuchung, Teilerstattung, Gepäck hinzufügen – für diese Airline aber noch manuell sein kann. Manche sind Low-Cost-Carrier, deren Content bei einem anderen Wiederverkäufer aggregiert wird: Sie können sie anzeigen, manchmal buchen, und dann kommt das Ticket über einen Weg, den Sie nicht steuern, in einer Frist, die Sie dem Kunden nicht zusagen können. Und manche stehen auf der Liste, weil irgendwann einmal ein Tarif in einer Suchantwort auftauchte.

Ein Carrier, den Sie anzeigen, aber nicht ticketieren können, ist keine Abdeckung. Für ein Endkundenprodukt ist er schlimmer als gar nicht vorhanden, denn der Kunde wählt ihn, zahlt und wartet dann.

Bei Hotels ist es dieselbe Form mit anderen Begriffen. Eine Objektzahl umfasst gemappte und nicht gemappte Häuser, statische Raten aus dem Cache der letzten Woche neben Live-Verfügbarkeit, Kontingentzimmer mit Release-Frist neben Free-Sale-Inventar. Fragen Sie nach der Zahl, die in Ihren Verkaufsstädten live buchbar ist, und danach, wie Dubletten zwischen den eigenen Lieferanten zusammengeführt werden – dasselbe Hotel dreimal zu drei Preisen ist ein Support-Ticket, das nur auf seinen Anlass wartet.

Der praktische Test ist eng gefasst. Schreiben Sie die zwanzig Strecken und zwanzig Hotelstädte auf, die den Großteil Ihres Volumens ausmachen – etwa Frankfurt–Antalya, München–Dubai, Düsseldorf–Palma –, und lassen Sie sich genau diese in der Sandbox durchgängig zeigen: Suche, Preis, Buchung, Ticketing oder Bestätigung, Storno. Ein Anbieter mit Tiefe macht das ohne Umstände. Ein Anbieter, der nur die Folie hat, fängt an, über die Folie zu reden.

Was im Test zu prüfen ist: Fehlerpfade, nicht Happy Paths

Jede Sandbox bucht erfolgreich ein Economy-Ticket für einen einfachen Flug auf einer ruhigen Strecke. Genau dafür wurde sie gebaut. Ihr echter Traffic wird einen nennenswerten Teil seiner Zeit auf den anderen Pfaden verbringen, und der Test ist der einzige günstige Moment, sie zu sehen.

Nutzen Sie den Test, um diese Liste abzuarbeiten, und notieren Sie, was die API zurückgab, neben dem, was danach tatsächlich zutraf:

  • Preisänderung zwischen Suche und Buchung. Schlägt die Buchung fehl, gelingt sie zum neuen Preis, oder kommt eine eigene Antwort, die eine Bestätigung verlangt? Kann Ihre Oberfläche den Unterschied erkennen, ohne einen Meldungstext zu parsen?
  • Abgelaufenes Angebot. Suchen, länger warten als die Angebotslebensdauer, dann buchen. Ist der Ablauf ein eigener Fehler oder derselbe wie „Lieferant nicht erreichbar“?
  • Ausverkauft bei der Buchung. Inventar, das zwischen Pricing und Buchung verschwindet. In welchem Zustand ist die Buchung, und wird eine Zahlungsautorisierung freigegeben?
  • Wiederholung nach Timeout. Buchungsanfrage senden, Verbindung vor der Antwort trennen, erneut senden. Haben Sie jetzt einen PNR oder zwei? Dieser eine Test verrät mehr über einen Anbieter als der Rest des Tests zusammen.
  • Buchung angelegt, Ticketing fehlgeschlagen. Kann die API einen bestehenden, nicht ticketierten PNR melden, und nennt sie die Ticketing-Frist?
  • Teilfehler. Eine Hotelanfrage mit mehreren Zimmern, bei der eines bestätigt wird und eines nicht. Ein Hin- und Rückflug, dessen Teile aus verschiedenen Quellen stammen.
  • Storno außerhalb der kostenfreien Frist. Wird die Gebühr vor der Bestätigung genannt oder erst auf der Rechnung entdeckt?
  • Lieferantenausfall. Fragen Sie, wie man ihn simuliert. Wenn das nicht geht, fragen Sie, wie die Kunden das Verhalten kennengelernt haben.

In jedem Fall bewerten Sie zwei Dinge. Sagt Ihnen die API die Wahrheit über den Zustand der Buchung? Und kann Ihr Code auf diese Wahrheit reagieren, ohne dass ein Mensch Freitext liest? Eine API, die klar scheitert, ist leichter zu ertragen als eine, die mehrdeutig gelingt.

Die Flugseite haben wir ausführlicher in was die Doku zur Flugbuchungs-API verschweigt behandelt, das Client-Design für langsame Hotellieferanten im Beitrag zur Hotelverfügbarkeit. Beide ergänzen einen Testplan gut.

Fragen, die einen dünnen Aggregator entlarven

An einem Aggregator ist nichts falsch. Der meiste Reise-Content erreicht die meisten Verkäufer über einen. Das Risiko ist der dünne: eine Schicht, die die API einer anderen Schicht weiterverkauft, eine Marge aufschlägt und weder den Lieferantenvertrag noch den operativen Desk besitzt. Wenn etwas bricht, muss die Antwort zwei Firmen hinauf- und wieder hinunterwandern.

Fünf Fragen bringen das schnell ans Licht:

  1. Wer ist der Lieferant dieser Buchung? Auf wessen Vertrag mit Airline oder Hotel beruht sie?
  2. Unter wessen IATA-Nummer und über welchen BSP läuft das Ticket? Lautet die Antwort „über einen Partner“, fragen Sie, wer das ADM bekommt, wenn eine Tarifregel verletzt wird.
  3. Was passiert bei Ihnen, wenn ich Storno aufrufe? Ein automatischer Aufruf beim Lieferanten oder eine Warteschlange, die ein Mensch abarbeitet?
  4. Kann ich den Fehler der Quelle sehen? Eine dünne Schicht neigt dazu, jeden Fehler auf einen Code einzuebnen, weil sie die Fehler, die sie erhält, nicht ganz versteht.
  5. Wen rufe ich bei einer hängenden Live-Buchung an, und wen ruft der an? Zählen Sie die Stationen.

Keine dieser Antworten disqualifiziert für sich allein. Die IATA-Nummer eines Partners kann in Ordnung sein, wenn der Vertrag klar regelt, wer die Belastungsanzeige trägt. Entscheidend ist, dass der Anbieter präzise und schnell antwortet. Vage Antworten hier sind die Antworten, die Sie später bekommen – in der Produktion, zu einer schlechteren Uhrzeit.

Was eine Fehlentscheidung kostet

Die Integration ist der billige Teil. Die teuren Teile kommen später und stehen in keiner Schätzung.

Ein Doppelbuchungsfehler bedeutet einen zweimal belasteten Kunden und einen PNR, den Sie von Hand suchen und stornieren müssen – womöglich nachdem das kostenlose Void-Fenster geschlossen ist. Eine Buchung, die vorgelagert gelang, während Ihr System einen Fehler verbuchte, bedeutet einen gehaltenen, dann automatisch stornierten Sitz und einen Kunden, der sich gebucht glaubt. Ein angezeigter, aber nicht ticketierbarer Carrier bedeutet eine Erstattung, eine Entschuldigung und einen Kunden, der nicht wiederkommt. Ein ADM für eine Tarifregel, die der Weg des Anbieters verletzt hat, landet bei dem, dem das Ticket gehört – klären Sie vorher, ob das Sie sind.

Dann sind da die Wechselkosten. Jede Anbieter-Eigenheit, die Sie auffangen – ein Statuscode mit zwei Bedeutungen, ein Feld, das manchmal ein String ist –, landet in Ihrem Datenmodell. Zwei Jahre später ist die API-Wahl keine Integration mehr, die man in einem Sprint austauscht; sie ist die Form Ihrer Buchungstabelle. Das ist der eigentliche Grund, jetzt sorgfältig zu vergleichen.

Wo unsere eigene API in diesem Rahmen steht

Wir stellen Flug- und Hotel-APIs bereit. Der Zugang beginnt mit einem Gespräch statt mit einem Self-Service-Key, was manche Entwickler langsam finden; der Grund ist, dass in diesem Gespräch die Fragen oben in beide Richtungen gestellt werden – welche Strecken und Städte Sie brauchen, welchen Content Sie tatsächlich ticketieren oder bestätigen können, wer nach der Buchung was übernimmt. Wenn Sie gerade vergleichen, bringen Sie diese Liste mit. Die Seite zu den Reise-APIs ist der Ort, an dem dieses Gespräch beginnt.

Wofür Sie sich auch entscheiden: Entscheiden Sie anhand des Testprotokolls, nicht anhand der Präsentation. Die Präsentation sagt Ihnen, was ein Anbieter sein möchte. Die Fehlerpfade sagen Ihnen, was er ist.

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.