Technische Dokumentation
Ein übergeordneter Überblick darüber, wie Partner sich an Verfügbarkeits-, Buchungs- und Inventar-Feeds anbinden. Die vollständige API-Referenz und Zugangsdaten werden mit freigegebenen Partnern geteilt.
Dies ist ein öffentlicher Überblick, nicht die vollständige Referenz. Kontaktieren Sie uns, um die vollständige API-Dokumentation, einen Sandbox-Key und Beispiel-Payloads für Ihr Konto zu erhalten.
Überblick
Die Connect API ist eine JSON-über-HTTPS-Schnittstelle, die den automatisierbaren Teil unseres Istanbul-Inventars bereitstellt: Verfügbarkeitssuche, Nettoraten-Preise und Buchung mit sofortiger Bestätigung. Feed-basierte Partner erhalten dieselben Produktdaten als strukturierten XML-Inventar-Feed.
Authentifizierung
Anfragen werden mit einem partnerspezifischen API-Key authentifiziert, der über TLS in einem Authorization-Header gesendet wird. Keys werden pro Umgebung (Sandbox und Produktion) während des Onboardings ausgestellt.
# Authorization-Header
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx
Accept: application/json
Verfügbarkeit
Fragen Sie Live-Verfügbarkeit und Nettoraten für ein Produkt und einen Datumsbereich ab, bevor Sie verkaufen. Die Antwort liefert buchbare Optionen mit Preisen und Regeln.
GET /v1/availability?product=hagia-sophia-grand-bazaar&date=2026-06-14
200 OK
{
"product": "hagia-sophia-grand-bazaar",
"currency": "EUR",
"available": true,
"options": [
{ "time": "09:00", "net": 149.50, "confirmation": "instant" }
]
}
Buchung
Legen Sie eine Buchung gegen eine verfügbare Option an. Eine erfolgreiche Antwort liefert bei Standardinventar sofort eine Bestätigungsreferenz und Voucher-Details.
POST /v1/bookings
{
"product": "hagia-sophia-grand-bazaar",
"date": "2026-06-14",
"time": "09:00",
"pax": { "adults": 2, "children": 1 },
"lead": { "name": "...", "email": "..." }
}
201 Created
{ "reference": "MKN-8F3A21", "status": "confirmed" }
Inventar-Feeds
Partner, die eine Katalog-Synchronisierung bevorzugen, erhalten einen XML-Feed mit Produkten, Beschreibungen, Raten und Regeln, der nach Zeitplan oder bei Bedarf abgerufen wird. Der Feed lässt sich sauber auf die meisten Agentur- und OTA-Kataloge abbilden.
GET /feed/inventory.xml <product code="hagia-sophia-grand-bazaar" type="tour"> <title>Hagia Sophia & Grand Bazaar Tour</title> <duration>PT8H</duration> <net currency="EUR">149.50</net> <pickup>hotel</pickup> </product>
Benötigen Sie die vollständige Referenz?
Freigegebene Partner erhalten die vollständige Endpunkt-Dokumentation, einen Sandbox-Key und Beispiel-Payloads. Schildern Sie uns Ihren Anwendungsfall, und wir richten den Zugang ein.
API-Dokumentation anfragen