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.
Übermittlungswege
Abschnitt betitelt „Übermittlungswege“| 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.
Übermittelte Daten
Abschnitt betitelt „Übermittelte Daten“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.
Weg 1: Abfrage
Abschnitt betitelt „Weg 1: Abfrage“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:
- Beim ersten Mal alle Kurse eines Zeitraums holen und
asOfaus der Antwort merken. - Danach regelmäßig mit
since=<asOf>fragen. Die Antwort trägt nur, was sich seither geändert hat, und ein neuesasOf. - Jeden Eintrag unter seiner
uidspeichern oder überschreiben.statussagt, ob der Platz gilt oder frei ist.
curl "https://skirent.sumware.at/api/ext/v1/courses?from=2026-12-27&to=2027-01-02" \ -H "Authorization: Bearer $SKI4ME_KEY"const res = await fetch("https://skirent.sumware.at/api/ext/v1/courses?from=2026-12-27&to=2027-01-02", { headers: { Authorization: `Bearer ${process.env.SKI4ME_KEY}`, },});
const data = await res.json();if (!res.ok) throw new Error(`${data.error.code}: ${data.error.hint}`);console.log(data);import osimport requests
res = requests.get( "https://skirent.sumware.at/api/ext/v1/courses", params={"from": "2026-12-27", "to": "2027-01-02"}, 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']}")print(data)<?php
$ch = curl_init('https://skirent.sumware.at/api/ext/v1/courses?from=2026-12-27&to=2027-01-02');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . getenv('SKI4ME_KEY'), ],]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if ($status >= 400) { throw new RuntimeException($data['error']['code'] . ': ' . $data['error']['hint']);}print_r($data);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 jsonimport osimport 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.
Weg 2: Kursmeldung
Abschnitt betitelt „Weg 2: Kursmeldung“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:
- die Signatur prüfen,
- die Meldung unter
course.uidspeichern, und eine Kennung inX-Skirent-Delivery, die sie schon kennt, überspringen, - schnell mit 2xx antworten.
Antwortet sie nicht, wiederholt Ski4me über gut anderthalb Tage. Einzelheiten unter Kursmeldungen.
Weg 3: Kursblatt
Abschnitt betitelt „Weg 3: Kursblatt“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.
Stornos
Abschnitt betitelt „Stornos“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.
Einschränkungen
Abschnitt betitelt „Einschränkungen“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.