Documentazione
API REST: guida rapida e riferimento
Autenticazione con chiave API, limiti di frequenza, paginazione e riferimento OpenAPI 3.1.
Automazione e sviluppatori
API REST per leggere e scrivere i piani
Progetti, attività, assegnazioni e dipendenze tramite API REST, con chiavi API a permessi limitati e riferimento OpenAPI 3.1.
- Disponibile
- Gratis, inclusa in ogni account
Cosa fa
Webhook e API REST per le tue automazioni
Per tutto ciò che non ha un’integrazione pronta: un evento firmato appena qualcosa cambia e un’API per leggere e scrivere il piano.
Dove serve
- Collegare Planitude a un sistema interno, a un ERP o a un data warehouse.
- Avviare un’automazione appena un’attività viene completata o spostata.
- Creare progetti e attività da un altro strumento, senza ricopiarli.
Da Planitude a Il tuo sistema
- Ogni modifica, che arrivi dall’app web, dall’API, da MCP o da un import → Eventi firmati, Da Planitude a Il tuo sistema
In entrambe le direzioni
- Progetti, attività, assegnazioni e dipendenze ↔ Lettura e scrittura via API REST, In entrambe le direzioni
Configurazione
Come si collega, in tre passi
Crea una chiave API
In Profilo → Chiavi API, in sola lettura o con modifica, eventualmente limitata a uno spazio di lavoro e con una scadenza.
Registra un webhook
Su un progetto o su un intero spazio di lavoro, scegliendo tra 14 eventi: attività create, completate o spostate, dipendenze, baseline, commenti e altri.
Ricevi e chiama
Verifica la firma HMAC-SHA256 di ogni evento e chiama l’API REST documentata in OpenAPI 3.1.
Requisiti
- Piano
- Gratuito. Tutte le integrazioni sono incluse in ogni account Planitude.
- Chi può collegarla
- Ogni utente, con la propria chiave API. Webhook di un progetto: proprietario o editor; webhook dello spazio di lavoro: proprietario o amministratore.
- Cosa serve
- Un endpoint HTTPS pubblico per ricevere i webhook; per l’API, una chiave creata in Profilo → Chiavi API.
Da sapere
- Zapier, Make e n8n sono in arrivo e useranno questa stessa API e questi webhook.
- Chiavi e app collegate non possono cancellare progetti o attività: la cancellazione resta nell’app web.
Guide e documentazione
Documentazione
Webhook: eventi, firme e nuovi tentativi
Catalogo degli eventi, verifica della firma HMAC-SHA256 e consegna con nuovi tentativi.
Guida
Gli strumenti da collegare a Planitude: guida alle integrazioni
Le integrazioni di Planitude: Jira, Azure DevOps, Slack, Teams, calendari, ChatGPT, Claude e Gemini via MCP, API e webhook, file .mpp e .xer. Quale scegliere.
Domande frequenti su API REST
Come verifico che un webhook arrivi davvero da Planitude?
Ogni richiesta porta un’intestazione con un timestamp e la firma HMAC-SHA256 del corpo: la ricalcoli con il segreto del webhook e scarti le richieste troppo vecchie. La documentazione per sviluppatori ha esempi pronti.
Un’integrazione via API può cancellare progetti?
No. Chiavi API e app collegate possono leggere e, con il permesso di modifica, creare e aggiornare, ma la cancellazione di progetti e attività resta nell’app web.
Le integrazioni hanno un costo?
No. Tutte le integrazioni sono incluse in Planitude, che è gratuito. Serve solo il tuo accesso all’altro strumento (per esempio un account Jira, Slack o Microsoft 365), alle sue condizioni.
Come si scollega un’integrazione?
Dalla pagina dell’app nel progetto, con Scollega, in qualsiasi momento. Non si cancella nulla: le attività restano in Planitude, issue e messaggi restano nell’altro strumento. Le app AI collegate si revocano da Profilo → Chiavi API.
I marchi citati (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) appartengono ai rispettivi titolari; Planitude non è affiliata né approvata da essi.