🧩 API & Integrationen
Eine vollständig dokumentierte offene REST-API, damit Ihre anderen Systeme Ihre Wäschedaten lesen und schreiben können.
Das Portal hat eine offene REST-API, damit Ihre eigenen Tools und Schwestersysteme (zum Beispiel die Wartungs-App) dieselben Daten lesen und schreiben können, die Sie auf dem Bildschirm sehen — Objekte, Wäsche-Zähllisten, Wäschereien, den Vault, Rechnungen, Statistiken und die Objektgruppen. Sie ist durch ein standardisiertes OpenAPI-3.1-Dokument beschrieben, sodass die meisten API-Tools es importieren und Ihnen einen Client bauen können. Diese Offenheit ist Absicht: Ihre Daten bleiben Ihre und sind nie eingesperrt.
Die Dokumentation (für alle offen)
- Durchsuchbare Referenz:
/api/docsöffnen — jeder Endpunkt mit seinen Parametern und Beispielantworten. - Maschinenlesbare Spezifikation:
/api/openapi.json— importieren Sie sie in Postman, Swagger UI, einen SDK-Generator oder Ihre CI. - Versionsstempel:
/api/version— die laufende Version und der Build-Hash, praktisch für Health-Checks.
An der API anmelden
- Daten-API (
/api/v1/…): senden Sie ein OIDC-Bearer-Token Ihres Identity Providers —Authorization: Bearer <token>. Akzeptiert wird jedes Admin-, Power-User- oder User-Token (Admin darf lesen und schreiben; Power-User und User sind schreibgeschützt). Die Audience des Tokens ist nicht eingeschränkt, sodass eine Schwester-App am selben Login diese API mit dem eigenen Token des angemeldeten Benutzers aufrufen kann (Single Sign-on). - Wäscherei-API (
/api/laundry/…): eine Wäscherei verbindet sich mit ihrem eigenen API-Schlüssel (Settings → Laundries), nicht mit einem Benutzer-Login — sie ruft ihre bestätigten Jobs ab und lädt ihre Rechnungen hoch.
Beispiel — Ihre Objekte auflisten: curl -H "Authorization: Bearer $TOKEN" https://IHRE-DOMAIN/api/v1/properties
/api/docs und probieren Sie einen GET /properties-Aufruf — er braucht nur ein schreibgeschütztes Token.