Documentation
API REST : démarrage rapide et référence
Authentification par clé d’API, limites de débit, pagination et référence OpenAPI 3.1.
Automatisation et développeurs
Une API REST pour lire et écrire les plannings
Projets, tâches, affectations et dépendances via une API REST, avec des clés d’API aux droits limités et une référence OpenAPI 3.1.
- Disponible
- Gratuite, incluse dans chaque compte
Ce qu’elle fait
Webhooks et API REST pour vos propres automatisations
Pour tout ce qui n’a pas d’intégration prête : un événement signé dès que quelque chose change, et une API pour lire et écrire le planning.
Dans quels cas
- Relier Planitude à un système interne, à un ERP ou à un entrepôt de données.
- Déclencher une automatisation dès qu’une tâche est terminée ou déplacée.
- Créer des projets et des tâches depuis un autre outil, sans les recopier.
De Planitude vers Votre système
- Chaque modification, qu’elle vienne de l’application web, de l’API, de MCP ou d’un import → Événements signés, De Planitude vers Votre système
Dans les deux sens
- Projets, tâches, affectations et dépendances ↔ Lecture et écriture via l’API REST, Dans les deux sens
Configuration
La connecter en trois étapes
Créez une clé d’API
Dans Profil → Clés d’API, en lecture seule ou en lecture et écriture, éventuellement limitée à un espace de travail et avec une date d’expiration.
Enregistrez un webhook
Sur un projet ou sur tout un espace de travail, en choisissant parmi 14 événements : tâches créées, terminées ou déplacées, dépendances, références, commentaires et autres.
Recevez et appelez
Vérifiez la signature HMAC-SHA256 de chaque événement et appelez l’API REST documentée en OpenAPI 3.1.
Prérequis
- Offre
- Gratuite. Toutes les intégrations sont incluses dans chaque compte Planitude.
- Qui peut la connecter
- Chaque utilisateur, avec sa propre clé d’API. Webhooks d’un projet : propriétaire ou éditeur ; webhooks de l’espace de travail : propriétaire ou administrateur.
- Ce qu’il faut
- Un point de terminaison HTTPS public pour recevoir les webhooks ; pour l’API, une clé créée dans Profil → Clés d’API.
Bon à savoir
- Zapier, Make et n8n arrivent bientôt et utiliseront cette même API et ces webhooks.
- Les clés et les applications connectées ne peuvent pas supprimer de projets ni de tâches : la suppression reste dans l’application web.
Guides et documentation
Documentation
Webhooks : événements, signatures et nouvelles tentatives
Catalogue des événements, vérification de la signature HMAC-SHA256 et livraison avec nouvelles tentatives.
Guide
Les outils à connecter à Planitude : guide des intégrations
Intégrations de Planitude : Jira, Azure DevOps, Slack, Teams, calendriers, ChatGPT, Claude et Gemini via MCP, API et webhooks, fichiers .mpp et .xer. Lesquelles choisir.
Questions fréquentes sur API REST
Comment vérifier qu’un webhook provient bien de Planitude ?
Chaque requête porte un en-tête avec un horodatage et la signature HMAC-SHA256 du corps : recalculez-la avec le secret du webhook et rejetez les requêtes trop anciennes. La documentation pour les développeurs fournit des exemples prêts à l’emploi.
Une intégration par API peut-elle supprimer des projets ?
Non. Les clés d’API et les applications connectées peuvent lire et, avec le droit d’écriture, créer et mettre à jour, mais la suppression des projets et des tâches reste dans l’application web.
Les intégrations sont-elles payantes ?
Non. Toutes les intégrations sont incluses dans Planitude, qui est gratuit. Il vous faut seulement votre propre accès à l’autre outil (par exemple un compte Jira, Slack ou Microsoft 365), selon ses conditions.
Comment déconnecter une intégration ?
Depuis la page de l’application dans le projet, avec Déconnecter, à tout moment. Rien n’est supprimé : les tâches restent dans Planitude, tickets et messages restent dans l’autre outil. Les applications d’IA connectées se révoquent depuis Profil → Clés d’API.
- WebhooksÉvénements HTTPS signés à chaque modification d’un projet.Disponible
- ZapierDéclencheurs et actions pour des milliers d’applications.Bientôt disponible
- MakeScénarios avec les modules Planitude et des déclencheurs instantanés.Bientôt disponible
- n8nNœud communautaire, aussi pour n8n auto-hébergé.Bientôt disponible
Les marques citées (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) appartiennent à leurs détenteurs respectifs ; Planitude n’est ni affiliée à eux ni approuvée par eux.