Ski4me
Dokumentation für Entwickler
Die offene Schnittstelle für Hotel, Skischule und Kasse, signierte Meldungen bei jeder Kursbuchung und ein MCP-Server je Betrieb. Alle Beispiele stammen aus mitgeschnittenen Aufrufen der Schnittstelle.
curl "https://skirent.sumware.at/api/ext/v1/whoami" \ -H "Authorization: Bearer $SKI4ME_KEY"{ "tenant": { "slug": "talstation", "name": "Skiverleih Talstation", "country": "AT", "currency": "EUR" }, "key": { "id": "01a1c478-a2b4-734d-827a-e37fd88d51e7", "name": "Hotel Alpenhof" }, "scopes": [ "day.view", "booking.edit" ]}Zugänge
Schnittstellen im Überblick
Welche passt, hängt davon ab, wer ruft: ein Programm des Betriebs, die Skischule oder der Assistent eines Gastes.
Offene Schnittstelle
Buchungen lesen, anlegen, ändern und stornieren, die Tour des Tages, Unterkünfte, Katalog und Kurse. Mit einem Schlüssel aus dem Portal und einzeln gewählten Rechten.
Alle EndpunkteMeldungen
Bei jeder Kursbuchung und jedem Storno geht eine signierte Nachricht an die Adresse der Skischule, mit Wiederholung, bis sie ankommt.
KursmeldungenKI-Agenten
MCP-Server je Betrieb, Buchungsentwurf und offene Endpunkte ohne Anmeldung. Ein Assistent bereitet den Warenkorb vor, der Gast zahlt selbst.
Zugänge für AssistentenAnleitungen
Anwendungsfälle
Hotel
Zustellstatus der eigenen Gäste abfragen und Zimmernummern nachtragen.
Zur AnleitungSkischule
Vermittelte Kurse abholen oder sich bei jeder Buchung melden lassen.
Zur AnleitungKassensystem
Buchungen für Laufkunden am Tresen anlegen, mit dem Preis des Servers.
Zur AnleitungBuchhaltung
Exporte als CSV und XLSX, Monatspaket, DATEV-Stapel und Rechnungen als ZUGFeRD.
Zur AnleitungWerkzeuge
Swagger, Postman und OpenAPI
Swagger
Jeden Endpunkt im Browser ansehen und mit dem eigenen Schlüssel aufrufen.
Swagger öffnenPostman Collection
Vorbelegte Anfragen mit Beispielantworten. Skripte setzen die Variablen für die nächste Anfrage.
Collection ladenOpenAPI-Dokument
Die Beschreibung in OpenAPI 3.1, erzeugt aus dem Code der Schnittstelle, mit Beispielen.
Dokument ladenBeispielprogramme
Vollständige kleine Programme in JavaScript, Python und PHP.
Programme ansehen