Zum Inhalt springen

Öffentliche API v1 & Webhooks

Export & Schnittstellen · 5 Min · Aktualisiert 24. Juli 2026

Über die öffentliche API v1 lassen sich PlanWerke-Daten anbinden. API-Schlüssel und Webhook-Endpunkte verwaltest du im Entwickler-Bereich (/app/entwickler).

  • API-Schlüssel pro Konto/Team erstellen und widerrufen.
  • Ein Schlüssel sieht die eigenen Projekte und die Projekte der Teams, in denen du Inhaber:in oder Mitglied bist – dieselbe Zugriffsregel wie in der App.
  • Webhooks für Ereignisse registrieren.
  • Details und Endpunkte siehe docs/api-v1.md im Repository.
API-Schlüssel sind wie Passwörter zu behandeln – nicht im Frontend oder in öffentlichen Repos hinterlegen.

Webhook-Zustellung: Der erste Versuch passiert sofort. Schlägt er fehl, wandert die Zustellung in eine dauerhafte Queue und wird im Hintergrund mit wachsendem Abstand wiederholt – erst nach mehreren erfolglosen Versuchen landet sie im Dead-Letter. Die Zustellung ist at-least-once – plane den Empfänger idempotent und dedupliziere über den Header PlanWerke-Event-Id.

War das hilfreich?