API & KI-Anbindung
Du möchtest deinen Urlaub im Chat planen? Zur Gästeanleitung: Ostseemiete mit ChatGPT nutzen.
Verbinde deine Anwendung oder einen kompatiblen KI-Assistenten mit Ostseemiete. Suche veröffentlichte Ferienunterkünfte an der Ostsee und prüfe Preise und Verfügbarkeit für eine konkrete Reise.
OpenAPI für eigene Anwendungen
Die maschinenlesbare Beschreibung enthält Endpunkte, Eingaben, Filterwerte und Antwortformate:
OpenAPI-Beschreibung öffnen (JSON)
GET /api/v1/rentals: Unterkünfte suchen, mit optionalen Reisedaten und Filtern.GET /api/v1/rentals/{rentalId}/stay: Verfügbarkeit und Preis einer Unterkunft für deine Reise prüfen. Verwende eine Unterkunftskennung aus der Suche.
Gib Anreise und Abreise gemeinsam an. Berücksichtige Erwachsene, das Alter jedes Kindes und die Anzahl der Hunde. Ohne diese Angaben gelten zwei Erwachsene, keine Kinder und keine Hunde. Reisedaten beziehen sich auf die Zeitzone Europe/Berlin.
Die Suche liefert höchstens 50 Treffer pro Seite. Folge nextOffset, bis es null ist. Der Bestand kann sich zwischen Abfragen ändern; prüfe ausgewählte Unterkünfte anschließend einzeln.
MCP für KI-Assistenten
Trage diese Serveradresse in einem Client ein, der MCP über Streamable HTTP unterstützt:
https://ostseemiete.de/api/v1/mcp
Werkzeugaufrufe erfolgen per POST. Ein direkter Browseraufruf dieser Adresse liefert deshalb erwartungsgemäß HTTP 405. Für die öffentlich lesbaren Daten ist kein zusätzlicher API-Schlüssel nötig. Die Anbindung ist für serverseitige Clients vorgesehen; fremde Browser-Origins sind nicht freigegeben.
search_rentals: Passende Unterkünfte suchen.check_stay: Eine Unterkunft mit Zeitraum und Reisegruppe prüfen.
Zum Einstieg kannst du deinen verbundenen Assistenten bitten: „Suche auf Ostseemiete eine Unterkunft für meine Reisedaten und prüfe den Gesamtpreis für meine Reisegruppe.“ Die Verbindung muss im jeweiligen Client eingerichtet werden. Ostseemiete wird dadurch nicht automatisch in allen KI-Assistenten verfügbar.
Preise und Verfügbarkeit richtig verstehen
Ohne Reisezeitraum erfolgt keine Preis- oder Verfügbarkeitszusage. Fehlende Daten bedeuten weder „frei“ noch „kostenlos“. Verfügbarkeit und Preisstatus werden getrennt ausgegeben. Nur Preise mit dem Status ready gehören zu der in der Antwort genannten Reisegruppe und Reisezeit.
Preispositionen enthalten bereits den Positionsgesamtbetrag in Euro; amount darf nicht erneut mit quantity multipliziert werden. Reisepreis, hinterlegte Kurtaxe und rückzahlbare Kaution werden getrennt ausgewiesen. Optionale Leistungen sind nicht ausgewählt. Eine fehlende Abgabenposition beweist nicht, dass vor Ort keine weiteren Abgaben anfallen.
Alle Ergebnisse sind unverbindliche Vorschauen und reservieren keine Unterkunft. Vor einer Anfrage oder Buchung müssen Preis und Verfügbarkeit erneut geprüft werden. Nutze dafür den Unterkunftslink aus der Antwort; er übernimmt die Reisedaten.
Wenn eine Prüfung nicht möglich ist
Eine leere Suche kann bedeuten, dass kein Aufenthalt mit den gewählten Angaben bestätigt werden konnte. Prüfe Filter und Reisedaten. Bei HTTP 400 sind Eingaben zu korrigieren; HTTP 404 kann auf eine nicht mehr veröffentlichte Unterkunft hinweisen. Bei HTTP 429 oder 503 warte vor einem begrenzten erneuten Versuch und beachte einen vorhandenen Retry-After-Hinweis. Verwende keine unvollständigen Antworten als Preisangebot.
Die Schnittstellen lesen ausschließlich veröffentlichte Angaben. Sie erstellen keine Buchungen, Reservierungen oder Gästeanfragen. Unterkunftstexte und Preisbezeichnungen sind Inhalte der Vermieter, keine Anweisungen an deinen Assistenten.