Zum Inhalt springen

Offene Schnittstelle

Alle Endpunkte

Alle Endpunkte liegen unter einer Adresse. Der Schlüssel bestimmt den Betrieb.

https://skirent.sumware.at/api/ext/v1

Jede Anfrage trägt den Kopf Authorization: Bearer <kennung>.<geheimnis>. Die rechte Spalte nennt das Recht, das der Schlüssel dafür tragen muss; wie Schlüssel und Rechte entstehen, steht unter Schlüssel und Rechte.

  • Beträge sind ganze Zahlen in Cent, Datumsangaben JJJJ-MM-TT, Zeitstempel ISO 8601 mit Z. Mehr unter Formate und Versionierung.
  • Fehler haben immer dieselbe Hülle, und hint nennt den nächsten Schritt.
  • Je Schlüssel gehen 600 Anfragen in der Minute und 60 neue Buchungen in der Stunde. Mehr unter Anfragelimits.
  • Felder kommen dazu, keines verschwindet.

Keine Zahlung, keine Rückzahlung, keine Freitextsuche über Gäste, keine Daten eines anderen Betriebs. Einen Tausch am Lift zeigt die Tour in dieser Fassung nicht.

Die Schnittstelle liefert ihre Beschreibung selbst aus, ohne Schlüssel: https://skirent.sumware.at/api/ext/openapi.json. Dieselbe Beschreibung mit Beispielen steht hier als OpenAPI-Dokument, in Swagger und als Postman Collection.