Documentație
REST API: ghid rapid și referință
Autentificare cu cheie API, limite de rată, paginare și referința OpenAPI 3.1.
Automatizare și dezvoltatori
API REST pentru citirea și scrierea planurilor
Proiecte, sarcini, alocări și dependențe printr-un API REST, cu chei API cu domeniu limitat și o referință OpenAPI 3.1.
- Disponibil
- Gratuit, inclus în fiecare cont
Ce face
Webhooks și REST API pentru automatizările dvs.
Pentru tot ce nu are o integrare gata făcută: un eveniment semnat imediat ce se schimbă ceva și un API pentru citirea și scrierea planului.
Unde ajută
- Conectați Planitude la un sistem intern, un ERP sau un data warehouse.
- Declanșați o automatizare imediat ce o sarcină este finalizată sau mutată.
- Creați proiecte și sarcini dintr-un alt instrument, fără a le copia manual.
De la Planitude la Sistemul dvs.
- Orice modificare, din aplicația web, API, MCP sau un import → Evenimente semnate, De la Planitude la Sistemul dvs.
În ambele sensuri
- Proiecte, sarcini, atribuiri și dependențe ↔ Citire și scriere prin REST API, În ambele sensuri
Configurare
Conectați-o în trei pași
Creați o cheie API
În Profil → Chei API, doar citire sau citire și scriere, opțional limitată la un workspace și cu dată de expirare.
Înregistrați un webhook
Pe un proiect sau pe un întreg workspace, alegând dintre 14 evenimente: sarcini create, finalizate sau mutate, dependențe, baseline-uri, comentarii și altele.
Primiți și apelați
Verificați semnătura HMAC-SHA256 a fiecărui eveniment și apelați REST API documentat în OpenAPI 3.1.
Cerințe
- Plan
- Gratuit. Fiecare integrare este inclusă în orice cont Planitude.
- Cine o poate conecta
- Fiecare utilizator, cu propria cheie API. Webhooks de proiect: proprietar sau editor; webhooks de workspace: proprietar sau administrator.
- Ce vă trebuie
- Un endpoint HTTPS public pentru primirea webhooks; pentru API, o cheie creată în Profil → Chei API.
Bine de știut
- Zapier, Make și n8n vor veni în curând și vor folosi același API și aceleași webhooks.
- Cheile și aplicațiile conectate nu pot șterge proiecte sau sarcini: ștergerea rămâne în aplicația web.
Ghiduri și documentație
Documentație
Webhooks: evenimente, semnături și reîncercări
Catalogul de evenimente, verificarea semnăturii HMAC-SHA256 și livrarea cu reîncercări.
Ghid
Instrumentele care se conectează la Planitude: ghid al integrărilor
Integrările Planitude: Jira, Azure DevOps, Slack, Teams, calendare, ChatGPT, Claude și Gemini prin MCP, API și webhook-uri, fișiere .mpp și .xer. Cum alegeți.
Întrebări frecvente despre API REST
Cum verific că un webhook provine cu adevărat de la Planitude?
Fiecare cerere conține un header cu un timestamp și semnătura HMAC-SHA256 a corpului: recalculați-o cu secretul webhook-ului și respingeți cererile prea vechi. Documentația pentru dezvoltatori conține exemple gata de folosit.
Poate o integrare API să șteargă proiecte?
Nu. Cheile API și aplicațiile conectate pot citi și, cu acces de scriere, pot crea și actualiza, dar ștergerea proiectelor și sarcinilor rămâne în aplicația web.
Integrările costă ceva?
Nu. Fiecare integrare este inclusă în Planitude, care este gratuit. Aveți nevoie doar de propriul acces la celălalt instrument (de exemplu un cont Jira, Slack sau Microsoft 365), conform termenilor acestuia.
Cum deconectez o integrare?
Din pagina aplicației din proiect, cu Deconectare, oricând. Nu se șterge nimic: sarcinile rămân în Planitude, tichetele și mesajele rămân în celălalt instrument. Aplicațiile AI conectate se revocă din Profil → Chei API.
Mărcile comerciale menționate (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) aparțin proprietarilor respectivi; Planitude nu este afiliat cu aceștia și nu este susținut de aceștia.