API-Dokumentation
REST-Schnittstelle, MCP-Zugang für KI-Assistenten und WebHooks.
REST
Basis /api/v1, z. B. /api/v1/projects oder /api/v1/activities, mit dem Header Authorization: Bearer wb_…. JSON in camelCase, Beträge und Stunden als Dezimalzahlen. Account-Schlüssel mit «Nur Lesen» erlauben nur GET-Anfragen.
MCP
Streamable HTTP unter /api/mcp mit demselben Header. Werkzeuge: whoami, Firmen, Projekte, Leistungen, Zeit erfassen, ändern und löschen, Timer, Personen.
claude mcp add --transport http werkbank https://<deine-domain>/api/mcp \ --header "Authorization: Bearer wb_…"
WebHooks
Je WebHook ein Objekt (z. B. Activity, Project) und eine Aktion (create, update, delete). Werkbank schickt einen HTTP-POST mit JSON { target, event, id, label, message, occurredAt, data? } und den Headern X-Werkbank-Target, X-Werkbank-Event, X-Werkbank-Timestamp, X-Werkbank-User-Id und X-Werkbank-Signature (sha256= HMAC des Bodys mit dem Signaturschlüssel aus der Liste). Die Antwort muss Status 2XX sein; nach zehn Fehlversuchen in Folge wird der WebHook deaktiviert.