Werkzeuge
Beispielprogramme
Die Beispiele auf den Seiten der Referenz zeigen je einen Aufruf. Hier steht, was ein Programm darum herum braucht: ein Aufruf an einer Stelle, Fehler als Fehler, Warten bei 429, und beim Start die Prüfung der Rechte.
Alle drei Fassungen tun dasselbe und lesen den Schlüssel aus der Umgebungsvariable SKI4ME_KEY.
Gemeinsame Aufruffunktion
Abschnitt betitelt „Gemeinsame Aufruffunktion“// ski4me.js, ab Node.js 18, ohne Abhängigkeitenconst BASE = 'https://skirent.sumware.at/api/ext/v1';
export class Ski4meFehler extends Error { constructor(status, error) { super(`${error.code}: ${error.message} ${error.hint ?? ''}`.trim()); this.status = status; this.code = error.code; this.hint = error.hint; }}
export async function ski4me(pfad, { method = 'GET', body, versuche = 3 } = {}) { for (let versuch = 1; ; versuch++) { const res = await fetch(BASE + pfad, { method, headers: { Authorization: `Bearer ${process.env.SKI4ME_KEY}`, ...(body === undefined ? {} : { 'Content-Type': 'application/json' }), }, body: body === undefined ? undefined : JSON.stringify(body), signal: AbortSignal.timeout(10_000), });
// 429 und 503 gehen vorüber: warten, so lange der Server sagt, dann noch einmal. if ((res.status === 429 || res.status === 503) && versuch < versuche) { const warten = Number(res.headers.get('retry-after') ?? 2 ** versuch); await new Promise((weiter) => setTimeout(weiter, warten * 1000)); continue; }
const data = await res.json(); if (!res.ok) throw new Ski4meFehler(res.status, data.error); return data; }}
/** Beim Start: bricht ab, wenn dem Schlüssel ein Recht fehlt. */export async function pruefeRechte(...noetig) { const ich = await ski4me('/whoami'); const fehlt = noetig.filter((recht) => !ich.scopes.includes(recht)); if (fehlt.length) { throw new Error(`Dem Schlüssel „${ich.key.name}“ fehlt: ${fehlt.join(', ')}`); } return ich;}# ski4me.py, braucht requestsimport osimport time
import requests
BASE = "https://skirent.sumware.at/api/ext/v1"
class Ski4meFehler(Exception): def __init__(self, status: int, error: dict): super().__init__(f"{error['code']}: {error['message']} {error.get('hint', '')}".strip()) self.status = status self.code = error["code"] self.hint = error.get("hint")
def ski4me(pfad: str, method: str = "GET", body=None, params=None, versuche: int = 3): for versuch in range(1, versuche + 1): res = requests.request( method, BASE + pfad, params=params, json=body, headers={"Authorization": f"Bearer {os.environ['SKI4ME_KEY']}"}, timeout=10, )
# 429 und 503 gehen vorüber: warten, so lange der Server sagt, dann noch einmal. if res.status_code in (429, 503) and versuch < versuche: time.sleep(int(res.headers.get("Retry-After", 2**versuch))) continue
data = res.json() if not res.ok: raise Ski4meFehler(res.status_code, data["error"]) return data
def pruefe_rechte(*noetig: str) -> dict: """Beim Start: bricht ab, wenn dem Schlüssel ein Recht fehlt.""" ich = ski4me("/whoami") fehlt = [recht for recht in noetig if recht not in ich["scopes"]] if fehlt: raise RuntimeError(f"Dem Schlüssel „{ich['key']['name']}“ fehlt: {', '.join(fehlt)}") return ich<?php// ski4me.php, braucht die Erweiterung curl
const SKI4ME_BASE = 'https://skirent.sumware.at/api/ext/v1';
class Ski4meFehler extends RuntimeException{ public function __construct(public int $status, public array $error) { parent::__construct(trim("{$error['code']}: {$error['message']} " . ($error['hint'] ?? ''))); }}
function ski4me(string $pfad, string $method = 'GET', ?array $body = null, int $versuche = 3): array{ for ($versuch = 1; ; $versuch++) { $kopf = ['Authorization: Bearer ' . getenv('SKI4ME_KEY')]; if ($body !== null) { $kopf[] = 'Content-Type: application/json'; }
$warten = null; $ch = curl_init(SKI4ME_BASE . $pfad); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_CUSTOMREQUEST => $method, CURLOPT_HTTPHEADER => $kopf, CURLOPT_HEADERFUNCTION => function ($ch, $zeile) use (&$warten) { if (stripos($zeile, 'retry-after:') === 0) { $warten = (int) trim(substr($zeile, 12)); } return strlen($zeile); }, ]); if ($body !== null) { curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body)); } $antwort = curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
// 429 und 503 gehen vorüber: warten, so lange der Server sagt, dann noch einmal. if (($status === 429 || $status === 503) && $versuch < $versuche) { sleep($warten ?? 2 ** $versuch); continue; }
$data = json_decode($antwort, true); if ($status >= 400) { throw new Ski4meFehler($status, $data['error']); } return $data; }}
/** Beim Start: bricht ab, wenn dem Schlüssel ein Recht fehlt. */function pruefeRechte(string ...$noetig): array{ $ich = ski4me('/whoami'); $fehlt = array_diff($noetig, $ich['scopes']); if ($fehlt) { throw new RuntimeException("Dem Schlüssel „{$ich['key']['name']}“ fehlt: " . implode(', ', $fehlt)); } return $ich;}Tour eines Tages melden
Abschnitt betitelt „Tour eines Tages melden“Ein Programm für den Fahrer: es zeigt die offenen Aufträge von heute und meldet einen als erledigt.
import { ski4me, pruefeRechte } from './ski4me.js';
await pruefeRechte('day.view', 'job.complete');
const heute = new Date().toISOString().slice(0, 10);const tag = await ski4me(`/days/${heute}`);
const offen = tag.jobs.filter((auftrag) => auftrag.status === 'open' && !auftrag.earlyDone);for (const a of offen) { const was = a.kind === 'delivery' ? 'Lieferung' : 'Abholung'; console.log(`${a.id} ${was} ${a.accommodation.name} ${a.booking.guestName} ${a.booking.persons} P.`);}
// Am Haus: erledigt, mit einer Notiz für das Büro.if (offen.length) { const ergebnis = await ski4me(`/jobs/${offen[0].id}`, { method: 'PATCH', body: { status: 'done', note: 'Im Skiraum abgestellt.' }, }); console.log(`Auftrag ${ergebnis.jobId}: ${ergebnis.status} um ${ergebnis.doneAt}`);}from datetime import date
from ski4me import pruefe_rechte, ski4me
pruefe_rechte("day.view", "job.complete")
tag = ski4me(f"/days/{date.today().isoformat()}")
offen = [a for a in tag["jobs"] if a["status"] == "open" and not a["earlyDone"]]for a in offen: was = "Lieferung" if a["kind"] == "delivery" else "Abholung" print(a["id"], was, a["accommodation"]["name"], a["booking"]["guestName"], a["booking"]["persons"], "P.")
# Am Haus: erledigt, mit einer Notiz für das Büro.if offen: ergebnis = ski4me( f"/jobs/{offen[0]['id']}", method="PATCH", body={"status": "done", "note": "Im Skiraum abgestellt."}, ) print(f"Auftrag {ergebnis['jobId']}: {ergebnis['status']} um {ergebnis['doneAt']}")<?phprequire 'ski4me.php';
pruefeRechte('day.view', 'job.complete');
$tag = ski4me('/days/' . date('Y-m-d'));
$offen = array_values(array_filter( $tag['jobs'], fn ($a) => $a['status'] === 'open' && !$a['earlyDone'],));foreach ($offen as $a) { $was = $a['kind'] === 'delivery' ? 'Lieferung' : 'Abholung'; echo "{$a['id']} $was {$a['accommodation']['name']} {$a['booking']['guestName']} {$a['booking']['persons']} P.\n";}
// Am Haus: erledigt, mit einer Notiz für das Büro.if ($offen) { $ergebnis = ski4me("/jobs/{$offen[0]['id']}", 'PATCH', ['status' => 'done', 'note' => 'Im Skiraum abgestellt.']); echo "Auftrag {$ergebnis['jobId']}: {$ergebnis['status']} um {$ergebnis['doneAt']}\n";}Buchungen eines Zeitraums abrufen
Abschnitt betitelt „Buchungen eines Zeitraums abrufen“Die Liste blättert. pages nennt, wie viele Seiten es gibt.
import { ski4me } from './ski4me.js';
async function* buchungen(from, to) { for (let page = 1, pages = 1; page <= pages; page++) { const seite = await ski4me(`/bookings?from=${from}&to=${to}&perPage=100&page=${page}`); pages = seite.pages; yield* seite.bookings; }}
let summe = 0;for await (const b of buchungen('2026-12-01', '2026-12-31')) { if (b.status === 'cancelled') continue; summe += b.totals.totalCents;}console.log(`Dezember: € ${(summe / 100).toFixed(2)}`);from ski4me import ski4me
def buchungen(von: str, bis: str): page, pages = 1, 1 while page <= pages: seite = ski4me("/bookings", params={"from": von, "to": bis, "perPage": 100, "page": page}) pages = seite["pages"] yield from seite["bookings"] page += 1
summe = sum(b["totals"]["totalCents"] for b in buchungen("2026-12-01", "2026-12-31") if b["status"] != "cancelled")print(f"Dezember: € {summe / 100:.2f}")<?phprequire 'ski4me.php';
function buchungen(string $von, string $bis): Generator{ for ($page = 1, $pages = 1; $page <= $pages; $page++) { $seite = ski4me("/bookings?from=$von&to=$bis&perPage=100&page=$page"); $pages = $seite['pages']; yield from $seite['bookings']; }}
$summe = 0;foreach (buchungen('2026-12-01', '2026-12-31') as $b) { if ($b['status'] !== 'cancelled') { $summe += $b['totals']['totalCents']; }}printf("Dezember: € %.2f\n", $summe / 100);Der Zeitraum bezieht sich auf den Anreisetag. Gerechnet wird in Cent, und erst die Anzeige teilt durch hundert.
Weitere Programme
Abschnitt betitelt „Weitere Programme“- Zustellstatus eines Hauses für das Hotel
- Kurse abholen ohne Lücke für die Skischule
- Signatur einer Meldung prüfen für die Gegenstelle der Skischule