API-Nutzung & Entwicklung (Debug-Modus)

Diese Seite ist nur im Development-Modus sichtbar und enthält Informationen für Entwickler und Tester.

REST-API

Die Plattform bietet eine vollständige REST-API unter https://localhost:7045/api/.

Die interaktive Dokumentation (Scalar) finden Sie unter: https://localhost:7045/scalar/v1

Alle API-Endpunkte (außer /register) benötigen einen JWT-Token.

{
  "email": "host@turnover.test",
  "password": "Test1234!Test"
}

Antwort:

{
  "accessToken": "eyJ...",
  "tokenType": "Bearer",
  "expiresIn": 3600
}

Authorization: Bearer eyJ...

Gruppe	Zweck
`/login`, `/register`	Anmeldung → JWT
`/api/users`	Konten, eigenes Profil (`/me`), Registrierung mit Name + Rolle (`/register`)
`/api/cleaners`	Reinigungskräfte: Profil (`/me`), eigene Termine
`/api/units`	Objekte (Gebäude → Wohnung → Raum → Gegenstand)
`/api/instructions`	Aufgaben-Vorlagen
`/api/plans`	Reinigungspläne
`/api/jobs`	Ausschreibungen (inkl. Bewerbungen und Vergabe)
`/api/taskbooks`	Arbeitszettel: Aufgaben, Nachweise, Zustimmung, Abschluss
`/api/approvals`	Zustimmungen bei Überschreitung der Höchstdauer
`/api/orders`	Aufträge: Versionen, Nachtrag, Fixpunkt
`/api/reports`	Leistungsnachweise
`/api/media`	Nachweis-Dateien (Upload/Abruf)
`/api/marketplace`	öffentlicher Marktplatz (ohne Anmeldung)
`/api/dev`	nur Development: `POST /clear-test-data` (reservierte Testdaten löschen), `POST /confirm-emails`
`/api/health`	Statusabfrage

Die vollständige und immer aktuelle Liste steht in der interaktiven Dokumentation (Scalar) und im OpenAPI-Dokument /openapi/v1.json.

Angelegt werden diese Konten vom Demodaten-Seeding (Passwort jeweils Test1234!Test):

Weitere Konten entstehen über POST /api/users/register; die Rolle wird dabei bei Bedarf angelegt.

Admin-Entwicklungsseite https://localhost:7145/Admin/DevData (nur in Development und für Admins):

Dev-Testdaten leeren → POST /api/dev/clear-test-data: löscht ausschließlich @turnover.test-Konten und deren Fachdaten; Admin-Konten und andere Konten bleiben erhalten.
Seeding ausführen → legt die Demodaten über die API an und zeigt das Protokoll.

Das Seeding läuft ausschließlich über öffentliche Endpunkte; Einzelheiten in seeding.md.