Pourquoi une API REST compte
La nouvelle référence API donne aux équipes un moyen direct de construire sur GanttFather. Au lieu d’exporter une feuille de calcul, de la modifier ailleurs puis de la réimporter, vos scripts peuvent lire et écrire les mêmes données de projet que votre équipe voit dans l’application.
C’est important pour les équipes opérations, les agences, les fondateurs et les créateurs d’outils internes. Un diagramme de Gantt est plus utile quand il reste proche du travail réel. L’API rend cela possible depuis des tâches planifiées, des tableaux de bord, des portails clients, des pipelines de déploiement et des intégrations légères.
Que pouvez-vous automatiser ?
La première surface publique de l’API se concentre sur les données de projet que les équipes demandent le plus souvent à automatiser :
- lister les projets accessibles par votre jeton
- lire, créer, mettre à jour, réordonner et supprimer des tâches
- garder le statut et l’avancement synchronisés
- définir les assignés et les dépendances de tâches
- lister les membres et les ressources
- créer, modifier ou supprimer des ressources non humaines comme du matériel, des salles et des lignes de budget
En pratique, vous pouvez créer un plan de lancement depuis un formulaire interne, mettre à jour un jalon quand un déploiement se termine ou refléter une partie du travail d’un autre outil dans une chronologie GanttFather.
Comment démarrer
Ouvrez GanttFather, allez dans Settings → AI Agents & API, puis créez un jeton. Ensuite :
- Lisez le guide d’authentification.
- Appelez list projects pour trouver l’id du projet.
- Essayez create task avec une petite tâche de test.
- Utilisez pagination et rate limits avant de lancer des synchronisations massives.
curl https://api.ganttfather.com/v1/projects \
-H "Authorization: Bearer glt_your_token" \
-H "User-Agent: your-integration-name/1.0"Le User-Agent est volontaire. Il aide le support à suivre les vraies intégrations, déboguer les cas limites et distinguer le trafic API du trafic navigateur anonyme.
API versus MCP
Utilisez l’API REST quand vous écrivez du code et que vous voulez des endpoints HTTP stables. Utilisez le guide du serveur MCP quand vous voulez qu’un assistant IA comme Claude, ChatGPT, Cursor ou Windsurf travaille avec votre projet via des outils de plus haut niveau.
Les deux utilisent la même zone de jetons dans GanttFather, et les deux sont inclus pour chaque utilisateur. La différence est l’interface : REST est pour votre programme ; MCP est pour votre agent.
Tarifs et limites
L’accès API est inclus dans tous les plans. La page des tarifs garde la même règle : chaque fonctionnalité est disponible dès le premier jour, et les options payantes ajoutent seulement de la capacité — plus de projets possédés ou plus d’éditeurs actifs.
Les limites API par défaut sont 60 requêtes par minute par jeton et 5 000 requêtes par jour par jeton. Les requêtes limitées renvoient 429 avec Retry-After; les réponses de quota quotidien incluent X-Quota-Remaining. Pour les grandes synchronisations, regroupez les écritures et évitez les boucles de mise à jour champ par champ. Voir Rate limits & quotas.
Le modèle d’intégration
Les intégrations les plus propres suivent souvent cette forme :
- garder une petite correspondance entre l’id de votre système et l’id de tâche GanttFather
- lire l’état actuel du projet avant d’écrire
- envoyer des mises à jour partielles seulement pour les champs modifiés
- utiliser des clés d’idempotence sur les opérations de création en cas de retry
- journaliser le trace id GanttFather quand quelque chose échoue
Commencez petit : listez les projets, créez une tâche, mettez-la à jour, puis branchez le flux sur votre propre système.
Commencez avec un jeton et gardez la référence ouverte à côté de votre éditeur.