Zum Inhalt springen

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.

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

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.

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:

  1. 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.
  2. Am 26.12. trägt das Hotel über die Schnittstelle die Zimmernummern nach.
  3. 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.
  4. 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.