Zum Inhalt springen
Blog

Kostenlose Hotelbuchungs-API: Was „kostenlos“ wirklich liefert

Tekravel Redaktion
Mit Unterstützung von KI geschrieben

Donnerstagnachmittag, die Demo ist am Montag. Sie haben eine kostenlose Hotelbuchungs-API gefunden, sich mit einer E-Mail-Adresse angemeldet und den Schlüssel in fünf Minuten erhalten. Der Such-Endpunkt liefert Hotels mit Fotos, Sternen und Nachtpreis. Bis zum Abend sieht die Ergebnisseite aus, wie sie soll. Am Freitag binden Sie den Buchungsaufruf an, und er antwortet mit einem Fehler, den Sie nicht lesen können, weil das, wofür Sie sich angemeldet haben, nie in der Lage war, etwas zu buchen.

Niemand hat Sie belogen. „Kostenlos“ klebt auf diesem Markt an vier verschiedenen Produkten, und die Anmeldeseiten sagen nicht, welches Sie in der Hand halten.

Vier Bedeutungen von „kostenlos“

Die Tabelle gehört neben die Tastatur. Widersprechen Sie einer Zeile, wenn Ihr Lieferant es anders macht; auch das ist ein nützlicher Befund.

Das kostenlose AngebotWas Sie bekommenWas Sie bauen könnenWas es nicht kann
Statischer Content oder VerzeichnisdatenHotelnamen, Adressen, Fotos, Ausstattung, BeschreibungenHotelführer, Karte, ZielseiteEinen Preis zeigen, zu dem Sie stehen können, oder ein Zimmer, das an Ihren Terminen wirklich frei ist
Affiliate-Suche mit WeiterleitungHotels, Preise und ein Link zur Kasse des VerkäufersEine Vergleichsseite, die Besucher weiterschicktKunde, Zahlung oder Buchungsdatensatz bei Ihnen behalten
Sandbox mit TestpreisenAlle Aufrufe für Suche, Preis, Buchung und Storno, beantwortet mit erfundenem BestandEine funktionierende Integration und eine Demo, die sich wie die Produktion verhältEine Reservierung erzeugen, die ein echtes Hotel anerkennt
Live buchbare PreiseEchte Zimmer zu echten Netto- oder Verkaufspreisen, vom Lieferanten bestätigtEinen Shop, der Geld für Zimmer annimmtFür den kostenlos sein, der den Vertrag unterschreibt

Die ersten drei sind gratis, weil sie den Anbieter fast nichts kosten. Das vierte ist nicht gratis, weil jemand etwas Reales trägt.

Warum ein buchbarer Preis immer mit einem Vertrag kommt

Zahlt Ihr Kunde für ein Zimmer, beginnt eine Kette von Pflichten. Ein Lieferant hält den Vertrag mit dem Hotel. Er hat dem Hotel versprochen, dass das Zimmer bezahlt wird, und Ihnen, dass es existiert. Storniert der Gast nach der kostenlosen Stornofrist, schuldet jemand dem Hotel eine Nacht. War der Preis falsch, trägt jemand die Differenz. War die Karte gestohlen, haftet jemand für die Rückbuchung.

All das muss bei einer benannten Partei landen. Ein API-Schlüssel, den jeder mit einer E-Mail-Adresse erzeugt, kann das nicht tragen; deshalb kommt buchbarer Zugang mit Vereinbarung, Abrechnungsmodell und oft einem Kreditlimit. Der Preis des „kostenlosen“ Schlüssels ist, dass dem Anbieter egal sein darf, was Sie damit tun.

Das ist keine Kritik an kostenlosen Stufen. Ein Content-Feed passt genau zu einem Reiseführer. Falsch wird er nur, wenn man ihn für das hält, was man braucht, um eine Buchung anzunehmen.

Wenn Sie auch entscheiden, wie viele Lieferanten Sie hinter dem gewählten brauchen, haben wir das in wie viele Hotel-API-Anbieter Sie brauchen durchgespielt; die Flugversion derselben Verwechslung steht in die drei Arten kostenloser Flug-APIs.

In der ersten Zeile steckt noch eine Falle. Statischer Content und Live-Preise sind zwei Feeds mit unterschiedlicher Lebensdauer: Die Beschreibung eines Hotels kann wochenlang im Cache liegen, der Preis für heute Nacht nicht einmal Minuten. Ein kostenloser Content-Feed, der auch einen Preis zeigt, nennt eine Zahl, für die er nicht einsteht, und eine darauf gebaute Seite zeigt munter ein Zimmer, das gestern ausverkauft war.

Was Sie in der Sandbox testen, bevor ein Vertrag unterschrieben wird

Die Sandbox ist das nützlichste Gratisangebot der Tabelle; nutzen Sie sie hart. Eine gute lässt Sie jeden Schritt einer echten Buchung ausführen, mit falschem Bestand in der Form des echten.

  1. Suchen Sie mit Kindern und mehreren Zimmern. Einfache Integrationen brechen zuerst bei der Belegung. Fragen Sie zwei Zimmer mit unterschiedlichen Gästen an und prüfen Sie, ob die Antwort sie getrennt hält.
  2. Preisprüfung vor der Buchung. Viele Lieferanten erwarten einen zweiten Aufruf, der bestätigt, dass der Preis noch gilt. Fehlt dieser Schritt in der Sandbox, fragen Sie, ob die Produktion ihn hat.
  3. Buchen, dann lesen, was zurückkommt. Ein bestätigtes Zimmer, eine offene Anfrage und ein Zimmer auf Anfrage sind drei verschiedene Ergebnisse, und Ihr Bildschirm muss sagen, welches.
  4. Ändern Sie den Preis zwischen Suche und Buchung. Preise bewegen sich. Wie sieht der Fehler aus, und kann Ihr Code dem Kunden den neuen Preis statt einer leeren Seite zeigen?
  5. Stornieren Sie innerhalb und außerhalb der kostenlosen Frist. Die Stornobedingung sollte als strukturierte Daten mit Daten und Beträgen kommen, nicht als Absatz, den Sie parsen müssen.
  6. Scheitern Sie absichtlich. Senden Sie ein falsches Datum, einen unbekannten Hotelcode, ein abgelaufenes Token. Zählen Sie, wie viele verschiedene Fehlerformen zurückkommen.

Kann die Sandbox die Schritte vier und fünf nicht, haben Sie eine Content-API mit buchungsförmiger URL.

Was es kostet, auf der falschen Art zu bauen

Die teure Version dieses Fehlers ist nicht die verlorene Woche. Es ist die Demo, die gut läuft.

Sie zeigen einer Entscheiderin eine saubere Suchseite, sie genehmigt das Budget, und erst dann stellt das Team fest, dass die Quelle dahinter kein Zimmer bestätigen kann. Der Code ist nicht ganz verloren, aber Buchungsstrecke, Zahlungsschritt, Stornobehandlung und Abrechnung müssen gegen einen anderen Lieferanten mit anderen Feldnamen neu gebaut werden. Die gezeigte Suchseite liefert dann andere Hotels, zu anderen Preisen, in anderer Reihenfolge. Wer das Budget genehmigt hat, wird es merken.

Die billigere Gewohnheit: vor der ersten Codezeile eine Frage stellen. „Kann dieser Schlüssel eine Reservierung erzeugen, die ein Hotel anerkennt, und sie danach stornieren?“ Ist die Antwort etwas anderes als Ja, wissen Sie, welche der vier Arten Sie halten.

Wo diese Plattform steht

Über die eigene Position sollten wir so offen sein wie über die der anderen. Die Plattform bietet Flug- und Hotel-APIs, und der Zugang beginnt mit einem Gespräch, nicht mit einem Self-Service-Schlüssel. Das ist die vierte Zeile der Tabelle: Hinter buchbarem Bestand steht jemand, der wissen muss, wer fragt. Wenn Sie sehen möchten, wie das für Ihr Vorhaben aussieht, beginnen Sie mit der Seite zu den Reise-APIs und sagen Sie uns, was Sie bauen.

Kostenloser Content, Affiliate-Links und Sandboxes haben alle ihren Platz, und der richtige hängt davon ab, was Sie verkaufen wollen. Wählen Sie danach, was der Schlüssel an dem Tag kann, an dem ein Kunde zahlt.

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.