Einstieg
Überblick
Ski4me hält die Buchungen eines Skiverleihs und gibt sie auf drei Wegen weiter. Welcher der richtige ist, hängt davon ab, wer ruft.
| Wer ruft | Weg | Anmeldung |
|---|---|---|
| Hotel, Skischule, Kassensystem, eigene Auswertung | Offene Schnittstelle unter /api/ext/v1 |
Schlüssel aus dem Portal |
| Skischule, die nicht abfragen will | Kursmeldungen an eine eigene Adresse | Signatur mit geteiltem Geheimnis |
| KI-Assistent eines Gastes | MCP-Server, Buchungsentwurf, offene Endpunkte | keine |
Dazu kommen die Exporte für die Buchhaltung und das Archiv im eigenen Speicher. Beide bedient der Betrieb im Portal.
Adressen
Abschnitt betitelt „Adressen“Die offene Schnittstelle läuft unter der Adresse der Plattform. Der Schlüssel bestimmt den Betrieb, der Host der Anfrage wird nicht gelesen. Zieht ein Betrieb auf eine andere Domain, ändert sich an den Aufrufen seiner Partner nichts.
https://skirent.sumware.at/api/ext/v1
Alles für KI-Agenten läuft dagegen auf der Domain des Betriebs. Dort bestimmt der Host den Betrieb, und es gibt keine Anmeldung. Ein Host, der zu keinem Betrieb gehört, bekommt 404.
https://skiverleih-talstation.example/mcp
Ausgeschlossene Funktionen
Abschnitt betitelt „Ausgeschlossene Funktionen“Die Grenze ist im Produkt eingebaut und hat keinen Schalter.
- Zahlen und zurückzahlen. Eine Buchung über die Schnittstelle entsteht ohne Zahlung, so wie das Büro sie im Portal anlegt. Ein Storno bewegt kein Geld; die Rückzahlung stößt der Admin im Portal an.
- Preise ändern, Personal verwalten, das Journal lesen. Diese Rechte lassen sich an keinen Schlüssel vergeben.
- Daten eines anderen Betriebs lesen. Jeder Betrieb hat seine eigene Datei, und ein Schlüssel öffnet genau eine.
Für KI-Agenten gilt dasselbe noch enger: ein Assistent bereitet einen Warenkorb vor, der Gast prüft und zahlt selbst.
Beispielbetrieb
Abschnitt betitelt „Beispielbetrieb“Jede Anfrage und jede Antwort auf diesen Seiten stammt aus einem Lauf der Schnittstelle gegen einen erfundenen Betrieb. Betrieb, Häuser, Gäste und Preise sind Beispiele.
| Betrieb | Skiverleih Talstation in Bergdorf, Domain skiverleih-talstation.example |
| Schlüssel „Hotel Alpenhof“ | day.view, booking.edit |
| Schlüssel „Skischule Bergdorf“ | course.view |
| Schlüssel „Kassensystem“ | alle wählbaren Rechte |
Der Ablauf dahinter, damit die Beispiele zusammenpassen:
- Familie Berger bucht am 14.11. auf der Website drei Ski-Sets für sechs Tage ab 27.12. ins Hotel Alpenhof, dazu einen Kinderkurs. Die Buchung heißt
SB-261114-WWNP. Die Skischule bekommt eine Meldung. - Am 26.12. trägt das Hotel über die Schnittstelle die Zimmernummern nach.
- Am 27.12. legt das Kassensystem zwei Buchungen für Laufkunden an, das Hotel fragt die Tour des Tages ab, und der Fahrer meldet die Lieferung.
- Eine zweite Online-Buchung,
SB-261112-WDZH, wird am 20.11. storniert. Auch das erfährt die Skischule.
Wer die Beispiele gegen den eigenen Betrieb nachstellt, bekommt andere Nummern und andere Preise, aber dieselbe Form.
Nächste Schritte
Abschnitt betitelt „Nächste Schritte“- Schnellstart: ein Schlüssel und drei Aufrufe.
- Alle Endpunkte der offenen Schnittstelle auf einer Seite.
- Swagger zum Ausprobieren im Browser, die Postman Collection zum Importieren.
- Anleitungen für Hotel, Skischule und Kassensystem.