Sie können jetzt direkt auf Veridien aufbauen. Dieselbe Engine, die unsere eigenen Buchungsabläufe antreibt, steht Ihnen offen: eine eigene Buchungsmaschine, eine mobile Gast-App, eine Treueprogramm-Anbindung oder beliebige Back-Office-Automatisierung.
Es ist eine gewöhnliche HTTP/JSON-Schnittstelle. Sie authentifizieren sich mit einem API-Schlüssel je Unterkunft, senden und empfangen snake_case-JSON und verlassen sich auf die Standard-Statuscodes und eine einzige, einheitliche Fehlerhülle. Jeder Schlüssel trägt Scopes, er kann also nur das, was Sie ihm erlauben, und nur auf der einen Unterkunft, zu der er gehört.
- API-Schlüssel je Unterkunft. Schlüssel erstellen, mit Scopes versehen und widerrufen Sie unter Einstellungen → API-Schlüssel. Ein Schlüssel wird einmal angezeigt und nur als Hash gespeichert.
- Zugriff nach Scopes. Zwölf feingliedrige Scopes (zum Beispiel
availability:read,reservations:write,folio:write) sichern jeden Endpunkt ab, darunter ein eigener Scopeguests:read:piifür sensible Gästedaten. - Der komplette Reservierungsablauf. Verfügbarkeit suchen, einen Aufenthalt mit sichtbarkeitsgesteuerten Raten bepreisen, einen Gast registrieren oder verknüpfen, Bestand blockieren, eine bezahlte Reservierung bestätigen und Gebühren auf das Gastkonto buchen.
- Treueprogramm. Punktestand und Stufe eines Gastes lesen, Punkte einlösen und bei bestätigten Aufenthalten automatisch sammeln.
- Sichere Wiederholungen. Ändernde Anfragen akzeptieren einen
Idempotency-Key, eine Wiederholung im Netz bucht also nie doppelt und belastet nie doppelt. Die Reservierungsbestätigung ist zusätzlich über ihre Zahlungsreferenz idempotent. - Vorhersehbare Fehler. Jeder Fehlschlag liefert eine typisierte Hülle mit einem stabilen
code, einem optionalenparamund einerrequest_id. - OpenAPI-3.1-Schema. Unter
/api/v1/openapi.jsonliegt eine maschinenlesbare Beschreibung jedes Endpunkts, aus der Sie typisierte Clients erzeugen.
| Bereich | Was Sie tun können |
|---|---|
| Katalog | Unterkunft, Zimmertypen, Verfügbarkeit und passende Ratenpläne lesen |
| Gäste | Gäste registrieren oder verknüpfen, Profile lesen und aktualisieren, Treuedaten lesen |
| Reservierungen | Bestand blockieren, Reservierungen bestätigen, auflisten und lesen, stornieren |
| Gastkonten | Das Gastkonto einer Reservierung lesen und Gebühren darauf buchen |
| Treueprogramm | Punktestände und Stufen lesen, Punkte einlösen |
Die vollständige Referenz, einen Schnellstart und Beispiele zum Kopieren finden Sie in der API-Dokumentation. Die Basis-URL ist https://veridien.app/api/v1.