API de gestion de projet : fonctionnalités et démarrage

L'API de gestion de projet permet à vos applications externes de créer, lire et mettre à jour vos projets et vos tâches. Elle compte 45 points d'accès répartis en 8 groupes. Elle s'adresse aux développeurs : si vous ne savez pas écrire de requêtes API, confiez l'intégration à un développeur.

Comment les données sont organisées

Ce que permet l'API

• Espaces, dossiers et listes : créer, consulter, modifier, supprimer, gérer la confidentialité et les accès des membres. Ajouter des membres par identifiant utilisateur ne retire pas les accès existants.

• Statuts : récupérer et remplacer les configurations de statuts. Une tâche est terminée quand son statusGroup vaut done.

• Tâches et sous-tâches : créer, modifier, rechercher, supprimer, créer des sous-tâches avec parentTaskId et renseigner des valeurs de champs personnalisés.

• Listes multiples : une tâche peut figurer dans plusieurs listes, avec une liste d'origine qui détermine sa configuration de statuts.

• Commentaires : consulter, créer, modifier et supprimer des commentaires, avec texte mis en forme et mentions. Seul l'auteur peut modifier ou supprimer son commentaire.

• Tâches récurrentes : créer, récupérer, modifier et supprimer des définitions, avec des options structurées plutôt que des chaînes RRULE brutes.

Démarrer

1. Vérifiez votre accès. Regardez Contacts puis Tâches dans votre compte.

2. Choisissez votre authentification. L'API accepte les jetons d'intégration privée, OAuth et APP Channel. Pour un jeton, ouvrez Paramètres puis Intégrations privé, cliquez sur Créer une nouvelle intégration, sélectionnez les autorisations et conservez le jeton en lieu sûr.

3. Configurez vos requêtes. Ajoutez l'authentification et l'en-tête Version: v3. Avec APP Channel, passez locationId en paramètre de requête. Sinon, le jeton détermine le compte.

4. Testez. Commencez par une requête en lecture seule, comme la récupération des espaces, et contrôlez la réponse.

Questions fréquentes