--- title: "GanttFather API Guide : Automatisez les projets Gantt avec REST | GanttFather Blog" description: "Créez un jeton GanttFather API, appelez la v1 REST API en toute sécurité, gérez les quotas et l'idempotence, et choisissez entre REST et MCP." canonical: "https://ganttfather.com/fr/article/gantt-father-api-reference-fr/" locale: "fr" category: "integrations" --- # GanttFather API Guide : Automatisez les projets Gantt avec REST | GanttFather Blog # GanttFather API Guide : Automatisez les projets Gantt avec REST Créez un jeton GanttFather API, appelez la v1 REST API en toute sécurité, gérez les quotas et l'idempotence, et choisissez entre REST et MCP. ![](https://ganttfather.com/logo.png) GanttFather Mis à jour 7 août 2026 9 min read Tags api integrations automation project-management The short answer Créez un jeton GanttFather API, appelez la v1 REST API en toute sécurité, gérez les quotas et l'idempotence, et choisissez entre REST et MCP. Le GanttFather REST API expose les opérations versionnées sur les projets, les tâches, les dépendances, les membres et les ressources pour les scripts et les intégrations. Authentifiez-vous avec un jeton GanttFather, envoyez un en-tête User-Agent non vide, commencez par des appels de lecture et utilisez une clé d’idempotence lors de la création d’une tâche ou d’une ressource qui peut être réessayée. **Comportement de API vérifié le 7 août 2026.** Traitez le [référence API en direct](https://ganttfather.com/docs/api/introduction/) comme contrat au niveau du point final. ## Que pouvez-vous automatiser avec le GanttFather API ? La version API v1 prend en charge les workflows d’intégration de planification courants : - lister les projets accessibles et inspecter un projet - lister et lire les tâches, les membres, les ressources et les dépendances - créer, mettre à jour partiellement, réorganiser et supprimer des tâches - ajouter ou supprimer des dépendances de tâches - créer, mettre à jour et supprimer des ressources - joignez votre propre mappage entre un enregistrement externe et un identifiant GanttFather Le API public n’est pas la même surface que le API interne du navigateur. Utilisez uniquement les points de terminaison et les champs de réponse v1 documentés. ## Comment créer et utiliser un jeton API ? Ouvrez GanttFather, accédez à **Paramètres → Agents IA et API** et créez un jeton avec la plus petite portée et autorisation utiles. Copiez le jeton brut lorsqu’il est affiché et stockez-le dans un gestionnaire de secrets ; GanttFather ne stocke pas la valeur brute pour un affichage ultérieur. Suivez ensuite cette séquence : - Lisez le [guide d’authentification](https://ganttfather.com/docs/api/authentication/). - Appelez [lister les projets](https://ganttfather.com/docs/api/list-projects/) pour trouver un identifiant de projet accessible. - Lisez les tâches avant de tenter une écriture. - Créez une tâche de test jetable. - Ajoutez la pagination, les nouvelles tentatives et la gestion des quotas avant une tâche en masse. Chaque demande doit inclure le jeton Bearer et un User-Agent non vide qui identifie le client. Un agent utilisateur manquant est rejeté avant la gestion normale du point de terminaison. ## Quelles règles de sécurité sont importantes pour les écritures ? Utilisez des mises à jour partielles uniquement pour les champs appartenant à votre intégration. Lisez l’état actuel avant de le modifier, enregistrez les identifiants stables et les informations de trace, et ne transformez pas chaque champ externe en un écrasement inconditionnel. Pour la création de tâches et de ressources, envoyez une **Idempotency-Key** lorsqu’un délai d’attente ou une panne de réseau peut entraîner une nouvelle tentative. La réutilisation de la clé avec la même requête renvoie le résultat précédent ; le réutiliser avec une requête différente est un conflit. Les mises à jour et les suppressions ont leur sémantique documentée et n’acceptent pas cette clé de création uniquement comme mécanisme de déduplication universel. Les dépendances et la hiérarchie sont des préoccupations distinctes. La réorganisation est le moyen autorisé de modifier le placement des parents ; les points de terminaison de dépendance modélisent les relations de prédécesseur. Validez les deux plutôt que de dériver l’un de l’autre. ## Quelles sont les limites de taux et de quotas quotidiens ? La protection par défaut est de **60 requêtes par minute par jeton authentifié** et de **5 000 requêtes par jour par jeton**. Une réponse limitée utilise HTTP 429 et fournit des informations de nouvelle tentative. Vérifiez le courant [documentation sur les limites de taux et les quotas](https://ganttfather.com/docs/api/rate-limits/) avant de planifier une charge de travail de production car les limites opérationnelles peuvent changer. Réduisez le volume des requêtes en paginant correctement, en lisant par lots, en mettant en cache les identifiants stables et en envoyant une mise à jour partielle au lieu d’une séquence de mises à jour par champ. Une boucle de nouvelle tentative doit respecter Retry-After et utiliser un intervalle exponentiel limité avec gigue. ## Quand devez-vous utiliser REST au lieu de MCP ? Utilisez REST lorsque le code d’application déterministe nécessite des ressources HTTP versionnées, des réponses d’erreur explicites et un comportement de nouvelle tentative contrôlé. Utilisez le [Serveur MCP](https://ganttfather.com/mcp/) lorsqu’un client IA tel que Claude doit appeler des outils de projet de niveau supérieur via Model Context Protocol. Les deux peuvent utiliser la voie des jetons de GanttFather, mais leurs opérations et entrées d’idempotence ne sont pas interchangeables. Une intégration API doit suivre la référence REST ; un agent doit suivre les descriptions des outils MCP. ## Qu’est-ce qu’un premier modèle d’intégration sûr ? Commencez avec une direction et un propriétaire pour chaque champ : Étape Comportement recommandé Découvrez Répertoriez les projets et enregistrez l’identifiant du projet sélectionné Lire Parcourez les tâches en cours et créez une carte d’identification Comparez Calculer un ensemble de modifications sans écrire Examen Journal prévu crée, met à jour et supprime Écrire Appliquer la plus petite mutation prise en charge Vérifier Lisez le résultat et enregistrez l’identifiant renvoyé Ne réclamez pas de « synchronisation » tant que la propriété du conflit, les règles de suppression, les tentatives et la récupération n’ont pas été définies. ## Quand devriez-vous construire sur les GanttFather API ? Utilisez le API lorsqu’un formulaire, un pipeline de déploiement, un portail client ou un système interne a besoin d’un accès reproductible aux mêmes données de projet que votre équipe voit dans GanttFather. Le premier cas d’utilisation le plus fiable est restreint (par exemple, créer une étape de publication après le déploiement), puis s’étendre après avoir observé des échecs et des tentatives réelles. Le API ne décide pas quel système possède un champ et ne rend pas un flux de travail multi-système sans conflit. Votre intégration doit définir ces règles. [Créer un projet GanttFather](https://ganttfather.com/fr/), émettez un jeton de moindre privilège et testez les données jetables avant de connecter les enregistrements de production. ## Questions fréquemment posées ### L’accès à API est-il inclus dans le niveau gratuit ? L’accès à API est actuellement disponible sur les forfaits GanttFather. Les limites de capacité et de protection s’appliquent toujours ; vérifier le [page de tarification](https://ganttfather.com/fr/pricing/) et la documentation sur les quotas API pour les conditions actuelles. ### À quoi ressemble un jeton GanttFather API ? Les jetons utilisent le format de jeton GanttFather et sont présentés comme informations d’identification du porteur. Ne confiez jamais un jeton au contrôle de code source et ne l’incluez jamais dans un journal public. ### L’agent utilisateur est-il facultatif ? Non pour les requêtes v1 normales. Envoyez une valeur non vide qui identifie votre intégration, telle qu’un nom et une version de produit. ### Chaque demande doit-elle inclure une clé d’idempotence ? Non. Utilisez-le pour les opérations de création documentées lorsque la même demande peut être réessayée. Il ne s’agit pas d’une version à usage général ou d’un en-tête de concurrence. ### Les API peuvent-ils configurer les sources d’intégration de Azure DevOps ? Les données publiques du projet v1 API et l’intégration Azure DevOps du produit sont des surfaces distinctes. Ne présumez pas qu’il existe un point de terminaison d’intégration non documenté. ### Où est la documentation OpenAPI ? Commencez par le [GanttFather API introduction](https://ganttfather.com/docs/api/introduction/) et suivez les liens de référence pour l’authentification, les points de terminaison, les schémas et les erreurs. ## Sources - [GanttFather APIdocumentation](https://ganttfather.com/docs/api/introduction/) - [Authentification](https://ganttfather.com/docs/api/authentication/) - [Pagination](https://ganttfather.com/docs/api/pagination/) - [Limites de taux et quotas](https://ganttfather.com/docs/api/rate-limits/) - [GanttFather MCPdocumentation](https://ganttfather.com/mcp/) ![](https://ganttfather.com/logo-hero.png) Want to skip the reading? GanttFather is free forever — no card, no trial. [Start free](https://app.ganttfather.com/login) Need help? Reach out to our team — we're happy to help. support@ganttfather.com Next up [Intégrations et IA Dépendances Azure DevOps dans un diagramme de Gantt : guide complet](https://ganttfather.com/fr/article/azure-devops-dependencies-gantt-chart-fr/)[Intégrations et IA Comment connecter Claude au calendrier de votre projet avec MCP](https://ganttfather.com/fr/article/connect-claude-to-project-schedule-mcp-fr/)[Intégrations et IA Comment visualiser Azure DevOps éléments de travail sur un diagramme de Gantt](https://ganttfather.com/fr/article/gantt-azure-devops-integration-guide-fr/) ![](https://ganttfather.com/logo-hero.png) GanttFather The Don of Project Management Every feature included — Gantt, Kanban, dependencies, critical path, real-time sync, Excel and AI agents. Free tier includes 1 project you own, 2 editor seats, and unlimited viewers and guests. [Start free](https://app.ganttfather.com/login)