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.
GET/whoamiBetrieb, Schlüssel und RechteGET/bookingsBuchungen auflistenbooking.viewPOST/bookingsEine Buchung anlegenbooking.createGET/bookings/{ref}Eine Buchung lesenbooking.viewPATCH/bookings/{ref}Eine Buchung ändernbooking.editGET/bookings/{ref}/cancel-proposalStornovorschlag lesenbooking.cancelPOST/bookings/{ref}/cancelEine Buchung stornierenbooking.cancelGET/days/{date}Aufträge eines Tagesday.viewPATCH/jobs/{id}Einen Auftrag meldenjob.completeGET/accommodationsUnterkünfte auflistenday.viewPOST/accommodationsEine Unterkunft anlegenaccommodation.editGET/accommodations/{id}Eine Unterkunft lesenday.viewPATCH/accommodations/{id}Eine Unterkunft ändernaccommodation.editDELETE/accommodations/{id}Eine Unterkunft entfernenaccommodation.editGET/settingsEinstellungen lesenday.viewPATCH/settingsEinstellungen ändernsettings.editGET/catalogKatalog lesenprice.viewGET/coursesKurse auflistencourse.viewGET/courses/{uid}Einen Kurs lesencourse.view
Gemeinsame Regeln
Abschnitt betitelt „Gemeinsame Regeln“- Beträge sind ganze Zahlen in Cent, Datumsangaben
JJJJ-MM-TT, Zeitstempel ISO 8601 mitZ. Mehr unter Formate und Versionierung. - Fehler haben immer dieselbe Hülle, und
hintnennt 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.
Nicht enthalten
Abschnitt betitelt „Nicht enthalten“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.
OpenAPI-Beschreibung
Abschnitt betitelt „OpenAPI-Beschreibung“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.