MustSeen API-Dokumentation
Willkommen bei der MustSeen API-Dokumentation. Hier finden Sie alles, was Sie benötigen, um unsere Reise-Intelligenz in Ihre Anwendung zu integrieren.
Unsere API basiert auf REST-Prinzipien und liefert vorhersagbare JSON-formatierte Antworten, unter Verwendung von Standard-HTTP-Antwortcodes und -Authentifizierung.
Authentifizierung
Die MustSeen API verwendet API-Schlüssel zur Authentifizierung von Anfragen. Sie können Ihre API-Schlüssel in Ihrem Entwickler-Dashboard einsehen und verwalten. Alle API-Anfragen müssen über HTTPS erfolgen und Ihren Schlüssel im Authorization-Header als Bearer-Token enthalten.
Authorization: Bearer YOUR_API_KEY Anfragen ohne Authentifizierung schlagen mit dem Statuscode 401 fehl.
Einen Reiseplan erstellen
Dies ist der Kern-Endpunkt der MustSeen-Plattform. Er nimmt die Absicht und die Einschränkungen eines Nutzers entgegen und gibt eine rangierte Liste von optimierten, buchbaren Reise-Paketoptionen zurück.
POST /v1/plan
Request Body
| Parameter | Type | Description |
|---|---|---|
| intent | string | Eine natürlichsprachliche Beschreibung der gewünschten Reise. Je detaillierter, desto besser das Ergebnis. |
| constraints | object | Ein Objekt, das feste Einschränkungen für die Reise enthält. |
| constraints.budget_eur | integer | Das maximale Gesamtbudget für die Reise in EUR. |
Fehlercodes
MustSeen verwendet konventionelle HTTP-Antwortcodes, um den Erfolg oder Misserfolg einer API-Anfrage anzuzeigen.
| Status Code | Meaning |
|---|---|
| 400 Bad Request | Ihre Anfrage hat fehlende oder ungültige Parameter. |
| 401 Unauthorized | Ihr API-Schlüssel ist falsch oder fehlt. |
| 429 Too Many Requests | Sie haben ein Rate-Limit erreicht. Bitte verlangsamen Sie Ihre Anfragen. |
| 500 Internal Server Error | Auf unserer Seite ist etwas schiefgelaufen. Bitte kontaktieren Sie den Support. |