Pour les développeurs

Construire sur Onplana

Lisez et modifiez projets et tâches depuis votre propre code, soyez prévenu des changements dès qu’ils arrivent, amenez le plan dans vos rapports et laissez des agents IA y travailler. Cinq accès, chacun avec un jeton qui agit comme la personne qui l’a créé.

Cinq accès

Chacun fonctionne aujourd’hui. Commencez par l’exemple, puis suivez son guide.

API REST avec jetons d’accès personnels

Créez un jeton dans Paramètres, puis Développeur, avec seulement les droits et les projets nécessaires et une date d’expiration. Il agit en votre nom, dans une organisation, et ne peut jamais faire plus que vous. La spécification OpenAPI 3.1 décrit chaque route.

Tous les forfaits, y compris le gratuit

Vos tâches ouvertes, dans tous les projets
curl https://api.onplana.com/api/tasks/mine \
  -H "Authorization: Bearer pat_YOUR_TOKEN"

Webhooks signés

Onplana envoie en POST une charge JSON à votre URL quand l’un des 22 types d’événements se produit. Chaque livraison porte une signature HMAC-SHA256 du corps, faite avec votre secret, et chaque tentative reste dans l’historique des livraisons.

À partir du forfait Business

Savoir quand une tâche change de statut
curl -X POST https://api.onplana.com/api/webhooks \
  -H "Authorization: Bearer pat_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Status changes","url":"https://example.com/onplana","events":["task.status_changed"],"secret":"YOUR_SECRET"}'

Le flux de reporting OData

Un flux OData v4 en lecture seule : projets, tâches, affectations, ressources, lignes de feuilles de temps, valeurs des champs personnalisés et références. Power BI, Excel ou votre entrepôt de données se connecte avec un jeton qui a le droit de reporting.

À partir du forfait Professional

Lire cinq tâches dans le flux
curl -u "token:pat_YOUR_TOKEN" \
  "https://api.onplana.com/api/odata/Tasks?$top=5"

Serveur MCP pour les agents IA

Claude, ChatGPT, Cursor et tout autre client MCP peuvent lire et gérer le travail avec les droits de la personne qui les connecte. Les clients se connectent dans le navigateur : aucune application à enregistrer au préalable.

Tous les forfaits, y compris le gratuit. Le nombre d’agents connectés en même temps augmente avec le forfait.

Ajouter Onplana à un client MCP
{
  "mcpServers": {
    "onplana": { "url": "https://mcp.onplana.com/mcp" }
  }
}

Connecteurs

Avant de construire, vérifiez si la connexion existe déjà. Chaque connecteur se connecte avec un jeton d’accès personnel et lance d’abord la même vérification.

  • Microsoft Teams et Microsoft 365 Copilot : disponibles, sur tous les forfaits, y compris le forfait gratuit.
  • Liens vers des fichiers SharePoint et OneDrive dans les tâches : disponibles, à partir du forfait Professional.
  • Power Automate et Power Apps : le connecteur est construit sur la même API et n’est pas encore publié.
  • Zapier : l’application est construite sur la même API et n’est pas encore publiée.

Les déclencheurs d’un connecteur abonnent un webhook : À partir du forfait Business.

La vérification de connexion d’un connecteur
curl https://api.onplana.com/api/organizations/current \
  -H "Authorization: Bearer pat_YOUR_TOKEN"

Comment fonctionne une requête

  • Envoyez le jeton comme jeton Bearer. Un jeton est lié à l’organisation où il a été créé : une requête n’a donc pas besoin d’en-tête d’organisation.
  • Les erreurs reviennent en JSON, avec une phrase que vous pouvez afficher, un code et un requestId à citer quand vous écrivez au support.
  • Les limites sont fixées par famille de routes. Une requête refusée répond 429 avec un en-tête Retry-After en secondes : attendez ce délai, puis réessayez.
  • La spécification se trouve sur api.onplana.com/api/openapi.json : vous pouvez en générer un client dans n’importe quel langage.

Le forfait de chaque accès

Lu dans la grille tarifaire, pour que cette liste et la page des tarifs concordent toujours.

Ce que vous utilisezForfait
API REST et jetons d’accès personnelsTous les forfaits, y compris le gratuit
WebhooksÀ partir du forfait Business
Flux de reporting ODataÀ partir du forfait Professional
Serveur MCPTous les forfaits, y compris le gratuit
Application Microsoft Teams et agent CopilotTous les forfaits, y compris le gratuit
Liens vers des fichiers SharePoint et OneDriveÀ partir du forfait Professional
Déclencheurs de connecteurs (ils abonnent un webhook)À partir du forfait Business

Les questions des développeurs

Existe-t-il un SDK ?

Non. L’API est du JSON sur HTTPS avec une spécification OpenAPI 3.1 : tout client HTTP convient, et vous pouvez générer un client typé à partir de la spécification.

L’API est-elle payante en plus ?

Non. L’API REST et les jetons sont inclus sur tous les forfaits, y compris le forfait gratuit. Les webhooks sont inclus à partir du forfait Business et le flux OData à partir du forfait Professional.

Mon application serveur peut-elle agir pour de nombreux clients ?

Pas encore via OAuth. Aujourd’hui, chaque client crée un jeton pour votre intégration, et ce jeton agit comme la personne qui l’a créé. Si votre produit a besoin de plus, dites-nous lequel.

Où sont les conditions d’utilisation de l’API ?

La page des conditions de l’API, dans la documentation développeur, décrit l’usage acceptable, ce que représente un jeton et la façon dont les changements incompatibles sont annoncés.

Créez votre premier jeton

Inscrivez-vous gratuitement, ouvrez Paramètres, puis Développeur, et créez un jeton avec les droits dont votre code a besoin.