Zum Inhalt springen

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.

// ski4me.js, ab Node.js 18, ohne Abhängigkeiten
const 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;
}

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}`);
}

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)}`);

Der Zeitraum bezieht sich auf den Anreisetag. Gerechnet wird in Cent, und erst die Anzeige teilt durch hundert.