Dokumentation
Webhooks: Ereignisse, Signaturen und Wiederholungen
Ereigniskatalog, Prüfung der HMAC-SHA256-Signatur und Zustellung mit Wiederholungen.
Automatisierung und Entwickler
Signierte Webhooks bei jeder Planänderung
Erhalten Sie ein signiertes HTTPS-Ereignis, sobald ein Vorgang angelegt, erledigt oder verschoben wird, in einem Projekt oder im ganzen Arbeitsbereich.
- Verfügbar
- Kostenlos, in jedem Konto enthalten
Was sie leistet
Webhooks und REST-API für Ihre eigenen Automatisierungen
Für alles ohne fertige Integration: ein signiertes Ereignis, sobald sich etwas ändert, und eine API zum Lesen und Schreiben des Plans.
Wofür sie sich eignet
- Planitude mit einem internen System, einem ERP oder einem Data Warehouse verbinden.
- Eine Automatisierung starten, sobald ein Vorgang erledigt oder verschoben wird.
- Projekte und Vorgänge aus einem anderen Tool anlegen, ohne sie abzutippen.
Von Planitude zu Ihr System
- Jede Änderung, ob aus der Web-App, der API, über MCP oder durch einen Import → Signierte Ereignisse, Von Planitude zu Ihr System
In beide Richtungen
- Projekte, Vorgänge, Zuordnungen und Abhängigkeiten ↔ Lesen und Schreiben über die REST-API, In beide Richtungen
Einrichtung
In drei Schritten verbunden
API-Schlüssel erstellen
Unter Profil → API-Schlüssel, nur lesend oder lesend und schreibend, optional auf einen Arbeitsbereich beschränkt und mit Ablaufdatum.
Webhook registrieren
Für ein Projekt oder einen ganzen Arbeitsbereich, mit Auswahl aus 14 Ereignissen: Vorgänge angelegt, erledigt oder verschoben, Abhängigkeiten, Basispläne, Kommentare und mehr.
Empfangen und aufrufen
Prüfen Sie die HMAC-SHA256-Signatur jedes Ereignisses und rufen Sie die in OpenAPI 3.1 dokumentierte REST-API auf.
Voraussetzungen
- Tarif
- Kostenlos. Alle Integrationen sind in jedem Planitude-Konto enthalten.
- Wer sie verbinden kann
- Jede Person mit dem eigenen API-Schlüssel. Projekt-Webhooks: Inhaber oder Bearbeiter; Arbeitsbereich-Webhooks: Inhaber oder Administrator.
- Was Sie brauchen
- Ein öffentlicher HTTPS-Endpunkt für die Webhooks; für die API ein Schlüssel aus Profil → API-Schlüssel.
Gut zu wissen
- Zapier, Make und n8n kommen demnächst und nutzen genau diese API und diese Webhooks.
- Schlüssel und verbundene Apps können keine Projekte oder Vorgänge löschen: Löschen bleibt der Web-App vorbehalten.
Leitfäden und Dokumentation
Dokumentation
REST-API: Schnellstart und Referenz
Authentifizierung per API-Schlüssel, Ratenbegrenzung, Paginierung und OpenAPI-3.1-Referenz.
Leitfaden
Welche Tools Sie mit Planitude verbinden sollten: Leitfaden zu den Integrationen
Planitude-Integrationen: Jira, Azure DevOps, Slack, Teams, Kalender, ChatGPT, Claude und Gemini per MCP, API und Webhooks, .mpp- und .xer-Dateien. Die richtige Wahl.
Häufige Fragen zu Webhooks
Wie prüfe ich, dass ein Webhook wirklich von Planitude kommt?
Jede Anfrage trägt einen Header mit Zeitstempel und der HMAC-SHA256-Signatur des Inhalts: Berechnen Sie sie mit dem Webhook-Geheimnis neu und verwerfen Sie zu alte Anfragen. Die Entwicklerdokumentation enthält fertige Beispiele.
Kann eine API-Integration Projekte löschen?
Nein. API-Schlüssel und verbundene Apps können lesen und mit Schreibrecht anlegen und ändern, das Löschen von Projekten und Vorgängen bleibt aber der Web-App vorbehalten.
Kosten die Integrationen etwas?
Nein. Alle Integrationen sind in Planitude enthalten, und Planitude ist kostenlos. Sie brauchen nur Ihren eigenen Zugang zum anderen Tool (zum Beispiel ein Jira-, Slack- oder Microsoft-365-Konto) zu dessen Bedingungen.
Wie trenne ich eine Integration?
Jederzeit auf der Seite der App im Projekt mit „Trennen“. Es wird nichts gelöscht: Vorgänge bleiben in Planitude, Issues und Nachrichten im anderen Tool. Verbundene KI-Apps widerrufen Sie unter Profil → API-Schlüssel.
Die genannten Marken (Jira, Azure DevOps, Slack, Microsoft Teams, Microsoft Outlook, Microsoft PowerPoint, Microsoft Project, Visual Studio Code, Google Calendar, Gemini, Apple Calendar, ChatGPT, Codex, Claude, Cursor, Zapier, Make, n8n, Primavera) gehören ihren jeweiligen Inhabern; Planitude ist mit ihnen weder verbunden noch von ihnen empfohlen.