Crea un token GanttFather API, chiama la v1 REST API in modo sicuro, gestisci quote e idempotenza e scegli tra REST e MCP.
GanttFather REST API espone operazioni di progetto, attività, dipendenza, membro e risorsa con versione per script e integrazioni. Autenticati con un token GanttFather, invia un’intestazione User-Agent non vuota, inizia con chiamate di lettura e utilizza una chiave di idempotenza durante la creazione di un’attività o di una risorsa che può essere ritentata.
Comportamento diAPI verificato il 7 agosto 2026. Tratta il riferimento live di API come contratto a livello di endpoint.
Cosa puoi automatizzare con GanttFather API?
La v1 API supporta i flussi di lavoro comuni di integrazione della pianificazione:
- elencare i progetti accessibili e ispezionare un progetto
- elencare e leggere attività, membri, risorse e dipendenze
- creare, aggiornare parzialmente, riordinare ed eliminare attività
- aggiungere o rimuovere le dipendenze delle attività
- creare, aggiornare ed eliminare risorse
- allega la tua mappatura tra un record esterno e un ID GanttFather
Il API pubblico non ha la stessa superficie del API interno del browser. Utilizza solo endpoint v1 e campi di risposta documentati.
Come si crea e si utilizza un token API?
Apri GanttFather, vai su Impostazioni → Agenti AI e API e crea un token con l’ambito e l’autorizzazione utili più piccoli. Copia il token grezzo quando viene mostrato e memorizzalo in un gestore segreto; GanttFather non memorizza il valore grezzo per una visualizzazione successiva.
Quindi segui questa sequenza:
- Leggi il guida all’autenticazione.
- Chiama elencare i progetti per trovare un ID progetto accessibile.
- Leggi le attività prima di tentare una scrittura.
- Creare un’attività di test usa e getta.
- Aggiungere l’impaginazione, i nuovi tentativi e la gestione delle quote prima di un processo in blocco.
Ogni richiesta deve includere il token Bearer e uno User-Agent non vuoto che identifichi il client. Un agente utente mancante viene rifiutato prima della normale gestione dell’endpoint.
Quali regole di sicurezza sono importanti per le scritture?
Utilizza aggiornamenti parziali solo per i campi di proprietà della tua integrazione. Leggere lo stato corrente prima di modificarlo, registrare ID stabili e informazioni di traccia e non trasformare ogni campo esterno in una sovrascrittura incondizionata.
Per la creazione di attività e risorse, inviare una Chiave di idempotenza quando un timeout o un errore di rete può causare un nuovo tentativo. Riutilizzare la chiave con la stessa richiesta restituisce il risultato precedente; riutilizzarlo con una richiesta diversa è un conflitto. Gli aggiornamenti e le eliminazioni hanno una semantica documentata e non accettano la chiave di sola creazione come meccanismo di deduplicazione universale.
Le dipendenze e la gerarchia sono preoccupazioni separate. Il riordino è il modo sanzionato per modificare il posizionamento del genitore; gli endpoint di dipendenza modellano le relazioni dei predecessori. Convalidare entrambi anziché derivare l’uno dall’altro.
Quali sono i limiti di tariffa e di quota giornaliera?
La protezione predefinita è 60 richieste al minuto per token autenticato e 5.000 richieste al giorno per token. Una risposta limitata utilizza HTTP 429 e fornisce informazioni sui nuovi tentativi. Controlla la corrente limiti tariffari e documentazione sulle quote prima di pianificare un carico di lavoro di produzione perché i limiti operativi possono cambiare.
Riduci il volume delle richieste impaginando correttamente, leggendo in batch, memorizzando nella cache gli ID stabili e inviando un aggiornamento parziale anziché una sequenza di aggiornamenti per campo. Un ciclo di tentativi dovrebbe rispettare Retry-After e utilizzare il backoff esponenziale limitato con jitter.
Quando dovresti usare REST invece di MCP?
Utilizza REST quando il codice dell’applicazione deterministica necessita di risorse HTTP con versione, risposte di errore esplicite e comportamento controllato dei tentativi. Usa il Server MCP quando un client AI come Claude deve invocare strumenti di progetto di livello superiore tramite Model Context Protocol.
Entrambi possono utilizzare la corsia dei token di GanttFather, ma le loro operazioni e gli input di idempotenza non sono intercambiabili. Un’integrazione API dovrebbe seguire il riferimento REST; un agente dovrebbe seguire le descrizioni dello strumento MCP.
Qual è un modello di prima integrazione sicuro?
Inizia con una direzione e un proprietario per ciascun campo:
| Passo | Comportamento consigliato |
|---|---|
| Scopri | Elenca i progetti e registra l’ID del progetto selezionato |
| Leggi | Sfoglia le attività correnti e crea una mappa ID |
| Confronta | Calcola un insieme di modifiche senza scrivere |
| Recensione | Registra le creazioni, gli aggiornamenti e le eliminazioni previste |
| Scrivi | Applicare la mutazione supportata più piccola |
| Verifica | Leggi il risultato e registra l’ID restituito |
Non rivendicare la “sincronizzazione” finché non vengono definiti la proprietà del conflitto, le regole di eliminazione, i nuovi tentativi e il ripristino.
Quando dovresti basarti su GanttFather API?
Utilizza API quando un modulo, una pipeline di distribuzione, un portale clienti o un sistema interno necessita di un accesso ripetibile agli stessi dati di progetto che il tuo team vede in GanttFather. Il primo caso d’uso più affidabile è ristretto: ad esempio, creare una fase cardine del rilascio dopo la distribuzione, quindi espanderlo dopo aver osservato errori e tentativi reali.
API non decide quale sistema possiede un campo né rende esente da conflitti un flusso di lavoro multi-sistema. La tua integrazione deve definire tali regole.
Crea un progetto GanttFather, emettere un token con privilegio minimo ed effettuare test rispetto ai dati usa e getta prima di connettere i record di produzione.
Domande frequenti
L’accesso a API è incluso nel livello gratuito?
L’accesso a API è attualmente disponibile per i piani GanttFather. Si applicano ancora limiti di capacità e protezione; verificare il pagina dei prezzi e documentazione sulla quota API per i termini attuali.
Che aspetto ha un token GanttFather API?
I token utilizzano il formato token GanttFather e vengono presentati come credenziali del portatore. Non impegnare mai un token nel controllo del codice sorgente né includerlo in un registro pubblico.
L’agente utente è facoltativo?
No per le normali richieste v1. Invia un valore non vuoto che identifichi la tua integrazione, ad esempio il nome e la versione del prodotto.
Ogni richiesta dovrebbe includere una chiave di idempotenza?
No. Utilizzarlo per operazioni di creazione documentate quando è possibile ritentare la stessa richiesta. Non è una versione generica o un’intestazione di concorrenza.
API possono configurare le origini di integrazione Azure DevOps?
I dati di progetto v1 pubblici API e l’integrazione del prodotto Azure DevOps sono superfici separate. Non dare per scontato che esista un endpoint di integrazione non documentato.
Dov’è la documentazione OpenAPI?
Inizia da GanttFather API introduzione e segui i collegamenti di riferimento per autenticazione, endpoint, schemi ed errori.
