Live-Demo

Leitfaden

Was ist API-Integration, erklärt für Reiseunternehmen

Eine API-Integration ist eine Verbindung, über die zwei Softwaresysteme Daten austauschen und Aktionen auslösen, ohne dass jemand etwas neu eintippt. Dieser Leitfaden erklärt die Funktionsweise anhand einer Hotelbuchung, die zwischen Reisendem, Buchungsplattform, Lieferanten-API und Zahlungsgateway unterwegs ist.

  • Eine Anfrage, eine Antwort
  • REST, XML, SOAP und Webhooks
  • Eine Buchung durch vier Systeme verfolgt
  • Wie Integrationen getestet werden

Die Definition

Was ist API-Integration, verständlich erklärt

API steht für Application Programming Interface: die Regeln, die ein System veröffentlicht, damit andere Software mit ihm sprechen kann. API-Integration ist die Arbeit, Ihre Plattform mit einer dieser Schnittstellen zu verbinden, sodass Daten fließen und Aktionen automatisch ablaufen.

Im Reisebereich ist diese Plattform meist ein Buchungssystem wie Reisebuchungssoftware, und die Schnittstelle gehört einem Lieferanten, einem Zahlungsgateway oder einem Geschäftswerkzeug. Unsere Seite Reise-API-Integration erklärt, wie PHPTRAVELS diese Verbindungen umsetzt, und Alle Integrationen listet die bereits angebundenen Lieferanten.

  • Daten austauschen

    Raten, Verfügbarkeit, Kundendaten und Statusmeldungen wandern in strukturierter Form zwischen den Systemen.

  • Aktionen automatisieren

    Suchen, Buchen, Bezahlen, Stornieren und Abgleichen geschehen als Anfragen, nicht als Schritte, die jemand von Hand wiederholt.

  • Ergebnisse nachverfolgen

    Jeder Aufruf trägt eine Referenz, sodass sich eine fehlgeschlagene Buchung bis zur auslösenden Anfrage zurückverfolgen lässt.

Anfrage

POST /v1/hotels/availability HTTP/1.1Host: api.supplier.exampleAuthorization: Bearer sk_test_••••••••Content-Type: application/json{  "city": "DXB",  "check_in": "2026-11-12",  "check_out": "2026-11-14",  "guests": 2,  "currency": "USD"}

Antwort

HTTP/1.1 200 OKContent-Type: application/jsonX-Request-Id: req_7f3a91{  "hotel": "Palm Marina Hotel",  "room": "Deluxe, 2 adults",  "rate": { "amount": 438.00, "currency": "USD" },  "refundable": true,  "rate_key": "rk_19d2c7"}
Beispielaufruf an einen fiktiven Hotellieferanten. Feldnamen, Endpunkte und Beträge unterscheiden sich von Lieferant zu Lieferant.

Anatomie eines API-Aufrufs

  1. 1

    Endpunkt und Methode

    Die Adresse der Operation und das darauf angewandte Verb: POST an availability bedeutet Zimmer suchen.

  2. 2

    Authentifizierung

    Ein Schlüssel, Token oder eine Signatur belegt, wer aufruft. Lieferanten vergeben getrennte Zugangsdaten für Sandbox und Produktion.

  3. 3

    Payload

    Die strukturierte Eingabe: Stadt, Daten, Gäste und Währung. Die Dokumentation des Lieferanten definiert jedes Feld.

  4. 4

    Statuscode

    Eine Zahl, die sagt, wie der Aufruf lief: 200 ist Erfolg, 4xx ein Problem mit der Anfrage, 5xx ein Problem auf Lieferantenseite.

  5. 5

    Request-ID

    Eine Kennung, die beide Seiten behalten. Wenn der Support fragt, was mit einer Buchung passiert ist, wird danach gesucht.

  6. 6

    Antwortinhalt

    Die Antwort im Format des Lieferanten, die Ihre Plattform auf ihre eigenen Zimmer, Raten und Richtlinien abbildet.

Eine Buchung, vier Systeme

Was API-Integration während einer Hotelbuchung leistet

Verfolgen Sie einen Aufenthalt von zwei Nächten von der Suche bis zum Voucher. Jeder Pfeil ist ein API-Aufruf; der Reisende sieht nur den ersten und den letzten.

  1. 01ReisenderBuchungsplattformSucht Hotels in Dubai, zwei Nächte, zwei Gäste
  2. 02BuchungsplattformLieferanten-APIVerfügbarkeitsanfrage mit Daten, Gästen und Währung
  3. 03Lieferanten-APIBuchungsplattformZimmer, Raten, Richtlinien und ein Ratenschlüssel
  4. 04BuchungsplattformReisenderErgebnisse mit Ihrem Aufschlag und Ihrer Währung angezeigt
  5. 05BuchungsplattformLieferanten-APIPreisprüfung des gewählten Ratenschlüssels vor der Zahlung
  6. 06BuchungsplattformZahlungsgatewayZahlungsautorisierung über den Gesamtbetrag
  7. 07ZahlungsgatewayBuchungsplattformAutorisiert, signierter Webhook empfangen
  8. 08BuchungsplattformLieferanten-APIBuchungsanfrage mit Gästedaten
  9. 09Lieferanten-APIBuchungsplattformBestätigungsnummer und Stornobedingungen
  10. 10BuchungsplattformReisenderVoucher, Rechnung und Buchungsreferenz

Die Plattform in der Mitte ist der Ort der API-Integration: Sie übersetzt zwischen dem Bildschirm des Reisenden und dem Format jedes Lieferanten und speichert jede Referenz.

Dieselbe Abfolge gilt für Flugbuchungssoftware mit einem GDS, Reiseveranstalter-Software mit einem Aktivitätenlieferanten und Zahlungs-Gateway-Integration mit jedem Gateway; nur die Feldnamen ändern sich.

Integrationsstile

REST, XML, SOAP, Webhooks und GraphQL

Lieferanten veröffentlichen ihre Schnittstellen in unterschiedlichen Stilen. Den Stil bestimmt die Dokumentation des Lieferanten, nicht die Vorliebe, deshalb muss eine Reiseplattform alle beherrschen.

  • REST und JSON

    JSON
    Datenformat
    JSON-Dokumente
    Transport
    HTTP-Methoden: GET, POST, PUT, DELETE
    Typisch im Reisebereich
    Neuere Flug-, Hotel-, Aktivitäten- und Zahlungs-APIs
    Stärke
    Kompakte Payloads und breites Entwickler-Tooling
    Zu beachten
    Lose spezifiziert; jeder Lieferant legt REST anders aus

  • XML und SOAP

    XML
    Datenformat
    XML-Dokumente, oft mit striktem Schema
    Transport
    HTTP POST mit SOAP-Envelope oder reinem XML
    Typisch im Reisebereich
    GDS, Bettenbanken und etablierte Hotel- und Toursysteme
    Stärke
    Formale Verträge, Signaturen und Servicedefinitionen
    Zu beachten
    Umfangreiche Nachrichten und aufwendigeres Parsen

  • Webhooks

    EVENT
    Datenformat
    JSON oder XML, von der Gegenseite gesendet
    Transport
    HTTP POST an eine von Ihnen registrierte URL
    Typisch im Reisebereich
    Zahlungsergebnisse, Statuswechsel von Buchungen, Ticketing-Updates
    Stärke
    Kein Polling; Ihre Plattform wird benachrichtigt, wenn etwas passiert
    Zu beachten
    Signaturen müssen geprüft, Wiederholungen behandelt werden

  • GraphQL

    QUERY
    Datenformat
    JSON, geformt durch die gesendete Abfrage
    Transport
    Ein einziger HTTP-Endpunkt
    Typisch im Reisebereich
    Einige neuere Vertriebsplattformen und interne APIs
    Stärke
    Genau die Felder anfordern, die Sie brauchen
    Zu beachten
    Unterstützung durch Reiselieferanten ist noch selten

API-Integration gegenüber API-Entwicklung

API-Integration

Verbindet Ihr Produkt mit einer Schnittstelle, die bereits existiert. Die API gehört dem Lieferanten; Sie bauen den Client, das Mapping und die Regeln darum herum.

API-Entwicklung

Erstellt eine Schnittstelle, über die andere Systeme sich mit Ihrem Produkt verbinden, etwa eine B2B-API, die die Tools Ihrer Agenten aufrufen können. Vertrag und Versionen gehören Ihnen.

Viele Reiseprojekte brauchen beides: Die Plattform integriert auf der einen Seite Lieferanten und veröffentlicht auf der anderen eine eigene API für Agenten und Partner.

Vorher und nachher

Was sich ändert, wenn Systeme integriert sind

Dieselben fünf Schritte einer Buchung, von Hand in Lieferantenportalen erledigt und über API-Integration erledigt.

Suchen

Ohne IntegrationManuell

Ein Agent öffnet jedes Lieferantenportal und kopiert Preise in ein Angebot.

Mit API-IntegrationAutomatisch

Eine Suche geht an alle angebundenen Lieferanten und liefert eine einzige Liste.

Preis

Ohne IntegrationManuell

Der Aufschlag wird in einer Tabelle ergänzt; bis das Angebot verschickt ist, kann sich die Rate geändert haben.

Mit API-IntegrationAutomatisch

Aufschlag, Steuern und Währungsregeln greifen bei der Antwort; die Rate wird vor der Zahlung erneut geprüft.

Buchen

Ohne IntegrationManuell

Gästedaten werden im Lieferantenportal neu eingetippt; Tippfehler werden zu Buchungsfehlern.

Mit API-IntegrationAutomatisch

Daten werden einmal gesendet, geprüft und mit der Bestätigung des Lieferanten gespeichert.

Bezahlen

Ohne IntegrationManuell

Die Zahlung wird separat eingezogen und später der Buchung zugeordnet.

Mit API-IntegrationAutomatisch

Autorisierung, Einzug und Erstattung sind an die Buchungsreferenz gebunden.

Betreuen

Ohne IntegrationManuell

Stornierungen und Änderungen bedeuten einen weiteren Login und eine weitere E-Mail.

Mit API-IntegrationAutomatisch

Änderungen und Stornierungen laufen über dieselbe Verbindung und aktualisieren den Datensatz.

Wo API-Integration in einer Reiseplattform vorkommt

Vokabular

Begriffe, die Ihnen in API-Dokumentationen begegnen

Zwölf Wörter, die in fast jedem Entwicklerportal eines Lieferanten auftauchen, definiert so, wie sie im Reisebereich verwendet werden.

  • API

    Application Programming Interface: die veröffentlichten Regeln, um mit einem System zu sprechen.

  • Authentifizierung

    Der Nachweis, wer aufruft, per API-Schlüssel, Bearer-Token, Signatur oder freigegebener IP-Adresse.

  • Zertifizierung

    Die Prüfung Ihrer Integration durch den Lieferanten, bevor Produktionszugangsdaten ausgegeben werden.

  • Endpunkt

    Eine Adresse für eine Operation, etwa Suchen, Buchen oder Stornieren.

  • Idempotenz

    Dieselbe Anfrage zweimal zu senden ergibt ein Ergebnis, was doppelte Buchungen und Abbuchungen verhindert.

  • Mapping

    Die Übersetzung der Felder, Codes und Namen des Lieferanten in das Datenmodell Ihrer Plattform.

  • Payload

    Die Daten innerhalb einer Anfrage oder Antwort, meist JSON oder XML.

  • Rate Limit

    Die Zahl der Aufrufe, die ein Lieferant pro Sekunde oder pro Tag erlaubt, bevor er sie abweist.

  • Anfrage und Antwort

    Ein Aufruf: Ihre Plattform fragt, der Lieferant antwortet, und beide Seiten protokollieren ihn.

  • Sandbox

    Eine Testumgebung mit fiktivem Bestand und Testkarten, in der nichts wirklich gebucht oder abgebucht wird.

  • Statuscode

    Die HTTP-Zahl, die das Ergebnis zusammenfasst: 200 Erfolg, 401 nicht autorisiert, 429 Rate Limit, 500 Lieferantenfehler.

  • Webhook

    Ein Aufruf in die andere Richtung: Lieferant oder Gateway benachrichtigt Ihre Plattform, wenn ein Ereignis eintritt.

Test und Scoping

Wie eine Reise-API-Integration vor dem Livegang getestet wird

Eine Integration ist erst fertig, wenn auch die Fehlerpfade sich richtig verhalten. Ein Testlauf gegen die Sandbox des Lieferanten deckt die folgenden Fälle ab, bevor Zertifizierung und Wechsel auf Produktionszugangsdaten folgen.

run integration tests

Lieferanten-Sandbox, neun Fälle

  • OK: Authentifizierung mit gültigen und abgelaufenen Zugangsdaten
  • OK: Ungültige Anfrage mit lesbarem Fehler abgewiesen
  • OK: Lieferanten-Timeout ohne hängende Buchung behandelt
  • OK: Rate Limit eingehalten und nach der Wartezeit erneut versucht
  • OK: Preisänderung bei der Prüfung erkannt und vor der Zahlung angezeigt
  • OK: Doppelte Übermittlung liefert die erste Buchung, keine zweite
  • OK: Stornierung angewandt und Gebühren berechnet
  • OK: Erstattung auf die ursprüngliche Zahlung ausgelöst
  • OK: Buchungs-, Zahlungs- und Lieferantenreferenzen stimmen überein

Alle Fälle bestanden, bereit zur Zertifizierung

Was das Scoping von Ihnen braucht

  1. 1Lieferantenvertrag, Dokumentation und Sandbox-Zugangsdaten
  2. 2Märkte, Währungen, Produkte und Benutzerrollen
  3. 3Umfang von Suche, Buchung, Änderung, Stornierung und Erstattung
  4. 4Zertifizierungsanforderungen und Prozess für den Produktionszugang

Bereit, einen Lieferanten anzubinden

PHPTRAVELS integriert Lieferanten, Gateways und Geschäftswerkzeuge in eine selbst gehostete Plattform, die mit Quellcode geliefert wird. Unter Preise finden Sie die drei Einmalpreis-Pläne, oder fragen Sie uns nach einer bestimmten API.

Demo anfragenSprechen Sie mit uns

Weiterlesen

Fragen

Fragen zur API-Integration, beantwortet

Kurze Antworten auf die Fragen, die vor dem ersten Integrationsprojekt gestellt werden.

Vertrieb kontaktieren

API-Integration ist eine Verbindung, über die zwei Softwaresysteme automatisch Daten austauschen und Aktionen auslösen. Ein System sendet eine strukturierte Anfrage, das andere liefert eine strukturierte Antwort, und beide halten sich an vereinbarte Regeln für Sicherheit und Daten.

Im Reisebereich verbindet sie eine Buchungsplattform mit Flug-, Hotel-, Tour- oder Mietwagenlieferanten, Zahlungsgateways und Geschäftswerkzeugen. Sie unterstützt Suche, Preisprüfung, Buchung, Stornierung, Erstattungen und Abgleich ohne Neueingabe.

REST ist ein Architekturstil, der meist JSON über HTTP austauscht. XML ist ein Datenformat, das bei GDS und Bettenbanken noch verbreitet ist, oft in SOAP verpackt. Vertrag und Dokumentation des Lieferanten entscheiden, welches Sie verwenden.

Das hängt vom Lieferantenzugang, den Endpunkten im Umfang, der Zertifizierung, den Mapping-Regeln und den Sonderfällen der Buchung ab. Eine verlässliche Schätzung folgt auf die Prüfung von Dokumentation, Zugangsdaten und den benötigten Abläufen.

Testen Sie Authentifizierung, gültige und ungültige Anfragen, Timeouts, Rate Limits, Preisänderungen, doppelte Übermittlungen, Stornierungen, Erstattungen und Abgleich. In der Produktion sollte jede Anfrage bis zu einer Buchungsreferenz nachvollziehbar sein.

Nein. Integration verbindet Ihr Produkt mit einer bestehenden API; Entwicklung erstellt eine Schnittstelle, mit der sich andere verbinden. Reiseplattformen brauchen oft beides: integrierte Lieferanten auf der einen Seite und eine für Partner veröffentlichte B2B-API auf der anderen.

Weiter entdecken

Mehr zur Plattform