Zum Inhalt springen

Integrationen

Skischule

Ein Betrieb auf Ski4me vermittelt Kurse einer Skischule. Der Vertrag besteht zwischen Gast und Schule, und die Schule muss jede Buchung erfahren, bevor der Gast am Treffpunkt steht.

Weg Wie Passt, wenn
Abfragen Die Schule ruft /courses mit einem eigenen Schlüssel ab. die Schule ein System hat, das regelmäßig nachsieht
Melden lassen Ski4me sendet eine signierte Meldung an eine Adresse der Schule. die Schule sofort Bescheid wissen will
Blatt Der Betrieb lädt im Portal unter Kurse eine Liste herunter und schickt sie selbst. die Schule kein System anbinden will

Die ersten beiden liefern dieselben Angaben in derselben Form. Sie lassen sich auch zusammen nutzen: Meldungen für den Alltag, eine Abfrage am Morgen als Abgleich.

Antwort200OK

{
"uid": "01a1db4a-b5a4-7331-84c1-5c71a25feb38",
"bookingRef": "SB-261114-WWNP",
"status": "booked",
"provider": "eigen",
"courseId": "kinder-3t",
"courseName": "Kinderkurs, 3 Tage",
"variantId": "1",
"date": "2026-12-28",
"days": 3,
"timeFrom": "10:00",
"meetingPointId": "schule",
"meetingPointName": "Treffpunkt der Skischule",
"skillId": "beginner",
"skillName": "Anfänger",
"language": "de",
"persons": 1,
"participants": [
{
"firstName": "Leon",
"lastName": "Berger",
"age": 11
}
],
"contact": {
"name": "Martin Berger",
"email": "martin.berger@example.org",
"phone": "+49 000 0000002"
},
"amountCents": 19500,
"currency": "EUR",
"bookedAt": "2026-11-14T18:22:44.270Z",
"updatedAt": "2026-11-14T18:21:08.900Z",
"reportedAt": "2026-11-14T18:23:26.640Z"
}

Kurs, Termin, Beginn, Treffpunkt, Sprache, Niveau, Teilnehmer mit Namen und Alter, eine Kontaktperson. Nichts aus dem Verleih, keine Unterkunft, keine Zahlungsdaten und nicht die Provision.

Der Betrieb legt einen Schlüssel mit dem Recht course.view an. Dieser Schlüssel sieht die Kurse und sonst nichts.

Der Ablauf, der keinen Kurs verliert:

  1. Beim ersten Mal alle Kurse eines Zeitraums holen und asOf aus der Antwort merken.
  2. Danach regelmäßig mit since=<asOf> fragen. Die Antwort trägt nur, was sich seither geändert hat, und ein neues asOf.
  3. Jeden Eintrag unter seiner uid speichern oder überschreiben. status sagt, ob der Platz gilt oder frei ist.
Terminal-Fenster
curl "https://skirent.sumware.at/api/ext/v1/courses?from=2026-12-27&to=2027-01-02" \
-H "Authorization: Bearer $SKI4ME_KEY"

Antwort200OK

Antwort anzeigen 75 Zeilen
{
"courses": [
{
"uid": "01a1db4a-b5a4-7331-84c1-5c71a25feb38",
"bookingRef": "SB-261114-WWNP",
"status": "booked",
"provider": "eigen",
"courseId": "kinder-3t",
"courseName": "Kinderkurs, 3 Tage",
"variantId": "1",
"date": "2026-12-28",
"days": 3,
"timeFrom": "10:00",
"meetingPointId": "schule",
"meetingPointName": "Treffpunkt der Skischule",
"skillId": "beginner",
"skillName": "Anfänger",
"language": "de",
"persons": 1,
"participants": [
{
"firstName": "Leon",
"lastName": "Berger",
"age": 11
}
],
"contact": {
"name": "Martin Berger",
"email": "martin.berger@example.org",
"phone": "+49 000 0000002"
},
"amountCents": 19500,
"currency": "EUR",
"bookedAt": "2026-11-14T18:22:44.270Z",
"updatedAt": "2026-11-14T18:21:08.900Z",
"reportedAt": "2026-11-14T18:23:26.640Z"
},
{
"uid": "01a1d0a1-941e-7285-840a-b1ba0e382d8d",
"bookingRef": "SB-261112-WDZH",
"status": "cancelled",
"provider": "eigen",
"courseId": "privat-1h",
"courseName": "Private ski lesson",
"variantId": "3",
"date": "2026-12-29",
"days": 1,
"timeFrom": "13:30",
"meetingPointId": "schule",
"meetingPointName": "the ski school meeting point",
"skillId": "advanced",
"skillName": "Advanced",
"language": "en",
"persons": 1,
"participants": [
{
"firstName": "Petra",
"lastName": "Novak",
"age": 36
}
],
"contact": {
"name": "Petra Novak",
"email": "petra.novak@example.org",
"phone": "+43 000 000004"
},
"amountCents": 7900,
"currency": "EUR",
"bookedAt": "2026-11-12T16:41:47.944Z",
"updatedAt": "2026-11-20T08:14:55.400Z",
"reportedAt": "2026-11-14T18:23:26.640Z"
}
],
"asOf": "2026-12-20T06:00:04.782Z"
}

In Python:

import json
import os
import pathlib
import requests
BASE = "https://skirent.sumware.at/api/ext/v1"
STAND = pathlib.Path("ski4me-stand.json") # merkt sich asOf zwischen den Läufen
def abholen() -> None:
params = {"limit": 1000}
if STAND.exists():
params["since"] = json.loads(STAND.read_text())["asOf"]
res = requests.get(
f"{BASE}/courses",
params=params,
headers={"Authorization": f"Bearer {os.environ['SKI4ME_KEY']}"},
timeout=10,
)
data = res.json()
if not res.ok:
raise RuntimeError(f"{data['error']['code']}: {data['error']['hint']}")
for kurs in data["courses"]:
speichere(kurs) # unter kurs["uid"], überschreibt den alten Stand
# Erst jetzt den Stand merken: scheitert das Speichern, kommt alles noch einmal.
STAND.write_text(json.dumps({"asOf": data["asOf"]}))
def speichere(kurs: dict) -> None:
frei = kurs["status"] == "cancelled"
namen = ", ".join(f"{p['firstName']} {p['lastName']}" for p in kurs["participants"])
print(kurs["date"], kurs["timeFrom"], kurs["courseName"], "STORNIERT" if frei else namen)
abholen()

Was die Schule abholt, gilt im Portal des Betriebs als gemeldet.

Der Betrieb trägt im Portal unter Einstellungen, Abschnitt Partner, die Adresse der Schule ein und gibt der Schule das Geheimnis, das dabei einmal erscheint.

MeldungPOSThttps://skischule-bergdorf.example/hooks/ski4me

Content-Type
application/json
User-Agent
SUMWARE-Skiverleih-Meldung/1
X-Skirent-Event
course.booked
X-Skirent-Delivery
01a1db4c-2a2e-710b-b76a-5b07501e7821
X-Skirent-Signature
t=1794680606,v1=b73242c707f3b58511d48aa7c161a748754a150098b0eabe044248d35e81c43d
{
"event": "course.booked",
"delivery": "01a1db4c-2a2e-710b-b76a-5b07501e7821",
"sentAt": "2026-11-14T18:23:26.640Z",
"tenant": "talstation",
"course": {
"uid": "01a1db4a-b5a4-7331-84c1-5c71a25feb38",
"bookingRef": "SB-261114-WWNP",
"status": "booked",
"provider": "eigen",
"courseId": "kinder-3t",
"courseName": "Kinderkurs, 3 Tage",
"variantId": "1",
"date": "2026-12-28",
"days": 3,
"timeFrom": "10:00",
"meetingPointId": "schule",
"meetingPointName": "Treffpunkt der Skischule",
"skillId": "beginner",
"skillName": "Anfänger",
"language": "de",
"persons": 1,
"participants": [
{
"firstName": "Leon",
"lastName": "Berger",
"age": 11
}
],
"contact": {
"name": "Martin Berger",
"email": "martin.berger@example.org",
"phone": "+49 000 0000002"
},
"amountCents": 19500,
"currency": "EUR",
"bookedAt": "2026-11-14T18:22:44.270Z",
"updatedAt": "2026-11-14T18:21:08.900Z",
"reportedAt": null
}
}

Die Gegenstelle der Schule tut drei Dinge:

  1. die Signatur prüfen,
  2. die Meldung unter course.uid speichern, und eine Kennung in X-Skirent-Delivery, die sie schon kennt, überspringen,
  3. schnell mit 2xx antworten.

Antwortet sie nicht, wiederholt Ski4me über gut anderthalb Tage. Einzelheiten unter Kursmeldungen.

Im Portal unter Kurse gibt es die vermittelten Kurse eines Zeitraums als Blatt für die Schule: je Kurstag die Kurse mit Beginn, Treffpunkt, Sprache, Niveau und Teilnehmern. Der Betrieb verschickt es selbst und markiert die Kurse danach als gemeldet.

Dieser Weg braucht keine Technik bei der Schule und ist der Rückfall, wenn eine Anbindung ausfällt.

Wird eine Buchung storniert, erfährt es die Schule auf demselben Weg wie die Buchung: als Meldung course.cancelled oder beim nächsten Abruf mit status: "cancelled". Die uid ist dieselbe.

Einen Rückweg gibt es nicht. Die Schule kann über Ski4me keinen Kurs bestätigen, ablehnen oder verschieben. Rückfragen gehen an den Betrieb; bookingRef nennt die Buchung, um die es geht.