Für Entwickler (API)

daagwerk stellt eine vollständige REST-API bereit – dieselbe, auf der Web- und Mobile-Apps aufsetzen. Ideal, um daagwerk mit eigenen Tools zu verbinden.

Interaktive API-Referenz (Swagger)

Die komplette, immer aktuelle Referenz mit „Try it out”:

→ https://api.daagwerk.de/docs

Jeder Endpunkt ist mit Beschreibung, Parametern, Antworttypen und Fehlercodes dokumentiert. Die OpenAPI-Spezifikation liegt unter https://api.daagwerk.de/docs/doc.json.

Basis-URL & Format

https://api.daagwerk.de

Alle Antworten sind JSON. Alle Endpunkte außer /auth/* und /health erfordern einen gültigen Token. Datumsangaben im Format YYYY-MM-DD.

Authentifizierung (JWT)

Zuerst anmelden, dann den Token als Bearer mitschicken:

POST /auth/login
Content-Type: application/json

{ "email": "du@example.com", "password": "•••••••" }

GET /entries?from=2026-01-01&to=2026-01-31
Authorization: Bearer <dein-token>

Typische Endpunkte

Zweck	Endpunkt
Struktur	`GET /accounts`, `GET /projects/{id}/jobs`
Zeiterfassung	`POST /timers/start`, `PUT /timers/{id}/stop`, `POST /entries`
Buchungen	`GET /entries`, `PUT /entries/{id}`
Auswertung/Export	`GET /reports`, `GET /export/entries.pdf`, `GET /export/entries.csv`
Bestellnummern	`GET /purchase-orders`, `POST /purchase-orders`

Rollen & Sichtbarkeit

Die API respektiert dieselben Rollen wie die App: sensible Felder (z. B. Stundensätze) liefert sie nur für Manager und höher; alle Daten sind strikt auf den eigenen Mandanten beschränkt.

Hinweise

Fehler kommen als JSON mit sprechendem Fehlercode.
Die API-Dokumentation ist bewusst auf Englisch – die Endpunkt-Beschreibungen sind ausführlich und auch für KI-/„Vibe-Coding”-Tools geeignet.