Hotel-API für Reiseunternehmen

Was die API abdeckt

Der Hotelablauf folgt der Reihenfolge, in der eine Buchung tatsächlich entsteht: ein Reiseziel suchen, die Live-Verfügbarkeit für ein Hotel abfragen, die gewählte Option auschecken (der Preis wird an dieser Stelle beim Lieferanten erneut validiert), bezahlen, bestätigen und später Buchungen auflisten, abrufen oder stornieren. Die zurückgegebenen Preise enthalten bereits den für Ihre Agentur hinterlegten Aufschlag.

Derselbe API-Schlüssel funktioniert auch für Privattransfers, einschließlich stundenweisem Chauffeurservice, und für Mietwagen. Sie integrieren ein Authentifizierungsverfahren, ein Fehlerformat und ein Nutzungsprotokoll für alle drei Produkte.

BASE="https://api.trekko.co/core"
AUTH="Authorization: ApiKey trk_test_xxxxxxxx:your_secret_here"

# 1) Search for the city
curl -sS "${BASE}/accommodation/search?query=Barcelona" -H "${AUTH}"

# 2) Live availability (prices already include your markup)
curl -sS -X POST "${BASE}/accommodations/get_accommodation_availability" \
  -H "${AUTH}" -H "Content-Type: application/json" \
  -d '{
        "accommodation_id": 1376114,
        "start_date": "2027-04-12",
        "end_date": "2027-04-15",
        "guests": [ { "id": 1, "age": 34 }, { "id": 2, "age": 30 } ],
        "guests_room_distribution": [ { "guest_ids": [1, 2] } ],
        "nationality": "ES",
        "currency_code": "EUR"
      }'

Ausgelegt für den Produktivbetrieb

Buchungs-APIs scheitern auf teure Weise: Ein Timeout während der Bestätigung kann eine doppelte Reservierung erzeugen. Der Bestätigungsaufruf akzeptiert einen Idempotency-Key-Header. Ein erneuter Versuch mit demselben Schlüssel liefert die ursprüngliche Antwort zurück, statt ein zweites Mal zu buchen.

Rate Limits gelten pro API-Schlüssel und nicht pro IP-Adresse, und die Grenzen jeder Agentur sind unabhängig, sodass der Datenverkehr eines anderen Partners Ihren nie drosselt. Fehler teilen sich ein gemeinsames Format, und bei der Authentifizierung wird wie üblich zwischen unbekannten Zugangsdaten und gültigen Zugangsdaten ohne Berechtigung unterschieden.

Webhooks und automatisches Rebooking

Über die API getätigte Buchungen kommen für das automatische Rebooking von Trekko infrage: Solange die kostenlose Stornierung noch offen ist, wird die Buchung täglich auf einen niedrigeren Preis für denselben Aufenthalt geprüft. Findet ein Rebooking statt, behält Ihre Buchung dieselbe stabile Kennung, und Ihr System erhält einen signierten booking.rebooked-Webhook mit altem und neuem Preis sowie der Ersparnis.

Webhooks sind per HMAC signiert, sodass Sie prüfen können, dass sie von Trekko stammen. Die Zustellung erfolgt mindestens einmal mit automatischen Wiederholungen; jedes Ereignis trägt eine Kennung, anhand derer Sie Duplikate erkennen. Für einzelne Buchungen können Sie das Rebooking auch über die API ausschließen.

Erst Sandbox, live nach der Aufladung

Melden Sie sich mit Ihrer E-Mail-Adresse für die Sandbox an, bestätigen Sie den Code, den wir senden, und Sie erhalten sofort Testzugangsdaten. Die Sandbox durchläuft den vollständigen Buchungsablauf auf einem festen Testkatalog, ruft nie einen echten Lieferanten auf, bewegt nie Geld und enthält einen Rebooking-Simulator, mit dem Sie den Webhook-Ablauf jederzeit testen.

Das Aufladen des Kontos erfordert keine separate Zahlungsintegration. Sie laden Ihr Trekko-Konto bis zur Mindesteinzahlung auf, per Kartenaufladung, Überweisung oder über eine vereinbarte Kreditlinie, beantragen den Produktionszugang und aktivieren ihn nach der Freigabe durch das Trekko-Team, um Ihren Live-Schlüssel zu erhalten. Beim Wechsel von der Sandbox in die Produktion tauschen Sie Schlüssel und Basis-URL aus, ergänzen den Zahlungsschritt, senden die vollständige Bestätigung und behandeln die Fehler, die die Sandbox nicht erzeugt.

Eine Checkliste für die Integration

Speichern Sie die bei der Bestätigung zurückgegebene stabile Buchungskennung und nicht die Bestätigungsnummer des Lieferanten, die sich nach einem Rebooking ändern kann. Senden Sie bei jeder Bestätigung einen Idempotency-Key. Prüfen Sie bei jedem Webhook die Signatur, bevor Sie handeln, und entfernen Sie Duplikate anhand der Ereigniskennung. Zeigen Sie Ihren Nutzern die Stornofrist, die mit jedem Angebot geliefert wird.

Wer die Trekko API integriert

Online-Reisebüros, die Hotels in ihre eigenen Websites einbauen, Reiseveranstalter, die eine Engine für dynamische Pakete speisen, Firmenreise-Tools, die Aufenthalte und Bodentransport benötigen, und Start-ups der Reisebranche, die Bestand wollen, ohne Lieferantenverträge einzeln zu verhandeln.

Häufige Fragen