Perché una API REST conta
Il nuovo riferimento API offre ai team un modo diretto per costruire sopra GanttFather. Invece di esportare un foglio di calcolo, modificarlo altrove e importarlo di nuovo, i tuoi script possono leggere e scrivere gli stessi dati di progetto che il team vede nell’app.
Questo conta per team operations, agenzie, founder e chi costruisce strumenti interni. Un diagramma di Gantt è più utile quando resta vicino al lavoro reale. L’API lo rende possibile da job pianificati, dashboard, portali clienti, pipeline di deploy e integrazioni leggere.
Cosa puoi automatizzare?
La prima superficie pubblica dell’API si concentra sui dati di progetto che le persone chiedono più spesso di automatizzare:
- elencare i progetti accessibili dal tuo token
- leggere, creare, aggiornare, riordinare ed eliminare attività
- mantenere stato e avanzamento sincronizzati
- impostare assegnatari e dipendenze delle attività
- elencare membri e risorse
- creare, aggiornare o rimuovere risorse non umane come attrezzature, sale e voci di budget
In pratica puoi creare un piano di lancio da un modulo interno, aggiornare una milestone quando finisce un deploy o riflettere lavoro selezionato da un altro strumento in una timeline GanttFather.
Come iniziare
Apri GanttFather, vai su Settings → AI Agents & API e crea un token. Poi:
- Leggi la guida di autenticazione.
- Chiama list projects per trovare l’id del progetto.
- Prova create task con una piccola attività di test.
- Usa pagination e rate limits prima di eseguire sincronizzazioni massive.
curl https://api.ganttfather.com/v1/projects \
-H "Authorization: Bearer glt_your_token" \
-H "User-Agent: your-integration-name/1.0"Il User-Agent è intenzionale. Aiuta il supporto a tracciare integrazioni reali, fare debug dei casi limite e tenere il traffico API distinto dal traffico anonimo del browser.
API versus MCP
Usa l’API REST quando stai scrivendo codice e vuoi endpoint HTTP stabili. Usa la guida al server MCP quando vuoi che un assistente IA come Claude, ChatGPT, Cursor o Windsurf lavori con il tuo progetto tramite strumenti di livello più alto.
Entrambi usano la stessa area token in GanttFather, ed entrambi sono inclusi per ogni utente. La differenza è l’interfaccia: REST è per il tuo programma; MCP è per il tuo agente.
Prezzi e limiti
L’accesso API è incluso in ogni piano. La pagina prezzi segue ancora la stessa regola: ogni funzionalità è disponibile dal primo giorno, e gli upgrade a pagamento aggiungono solo capacità — più progetti di tua proprietà o più editor attivi.
I limiti API predefiniti sono 60 richieste al minuto per token e 5.000 richieste al giorno per token. Le richieste limitate restituiscono 429 con Retry-After; le risposte di quota giornaliera includono X-Quota-Remaining. Per sync più grandi, raggruppa le scritture ed evita loop di aggiornamento campo per campo. Vedi Rate limits & quotas.
Il pattern di integrazione
Le integrazioni più pulite di solito seguono questa forma:
- mantieni una piccola mappatura tra l’id del tuo sistema e l’id della task in GanttFather
- leggi lo stato attuale del progetto prima di scrivere
- invia aggiornamenti parziali solo per i campi cambiati
- usa chiavi di idempotenza nelle operazioni di creazione quando ritenti
- registra il trace id di GanttFather quando qualcosa fallisce
Inizia piccolo: elenca i progetti, crea una task, aggiornala e poi collega il flusso al tuo sistema.
Inizia con un token e tieni la reference aperta accanto al tuo editor.