Recherche

Créer votre propre application avec l’API ClickUp

Envie de créer une appli qui s’intègre avec ClickUp ? Donnez à vos utilisateurs la possibilité de se connecter avec OAuth 2.0 ! 
Pensez à lire notre document sur les API !

Ce dont vous aurez besoin

Flux OAuth 2

Lorsque vous souhaitez développer une application utilisable par d’autres personnes, vous devez utiliser un flux d’authentification OAuth 2.
Avec OAuth 2, chaque personne utilisant votre appli se voit attribuer un jeton individuel. Chaque utilisateur peut uniquement accéder au contenu disponible sur son compte ClickUp individuel.

Si vous ne connaissez pas OAuth 2, Digital Ocean a rédigé un excellent guide qui vous aidera à vous lancer. Nous recommandons également de consulter le site Web d’OAuth pour plus d’informations.

Créer une application

La première étape pour utiliser OAuth consiste à créer une appli dans votre environnement de travail. Pour gérer les paramètres d’intégration, vous devez être propriétaire ou administrateur de l’environnement de travail. Voici comment procéder :
  1. Dans le coin supérieur droit, cliquez sur votre avatar personnel.
  2. Sélectionnez Paramètres. 
  3. Dans la barre latérale, sélectionnez API ClickUp.
  4. Cliquez sur + Créer une nouvelle application.
  5. Saisissez le nom de votre application et une ou plusieurs URL de redirection.
    Si vous n'êtes pas sûr de l'URL de redirection à utiliser, consultez le guide des URL de redirection sur le site web d'OAuth.
  6. Cliquez sur Créer l’application.
  7. Sur l’écran suivant s’affichent un identifiant client et un secret client.
  8. Utilisez l’identifiant client et le secret client pour créer un flux d’authentification OAuth 2 dans votre appli.

Capture d’écran du modal de l’appli utilisation OAuth 2.

Mettre à jour vos URL de redirection

Si vous avez une nouvelle URL de redirection, vous pouvez mettre à jour ces paramètres dans votre environnement de travail ClickUp à tout moment :
  1. Dans le coin supérieur droit, cliquez sur votre avatar personnel.
  2. Sélectionnez Paramètres. 
  3. Dans la barre latérale, sélectionnez API ClickUp.
  4. Cliquez sur une application existante pour afficher ses détails.
  5. Mettez à jour l’URL de redirection.
  6. Cliquez sur Enregistrer.

Afficher votre secret client ou en générer un nouveau

Pour générer votre nouveau secret client :
  1. Dans le coin supérieur droit, cliquez sur votre avatar personnel.
  2. Sélectionnez Paramètres. 
  3. Dans la barre latérale, sélectionnez ClickUp IA.
  4. Cliquez sur une application existante pour afficher ses détails.
  5. Cliquez sur Afficher pour visualiser votre secret client actuel.
  6. Cliquez sur Régénérer pour créer un nouveau secret client.
  7. Mettez votre application à jour pour utiliser le nouveau secret client.

Types de jetons d’autorisation

Les jetons vous permettent de réaliser des appels d’API et de l’intégrer avec d’autres applications. Vous pouvez également utiliser des applis comme Make pour créer des intégrations sans écrire de code. Les jetons sont spécifiques à votre compte utilisateur ClickUp.
Toute personne disposant d’un compte ClickUp peut générer un jeton personnel. Les jetons personnels permettent l’accès à tous les environnements de travail que votre compte a créé ou rejoint. Votre jeton personnel vous donne le même accès que celui d’un navigateur web.
Si vous utilisez OAuth 2, vous pouvez choisir d’autoriser l’accès à des environnements de travail spécifiques lorsque vous vous authentifiez pour la première fois, puis les fois suivantes.
Capture d’écran d’une personne sélectionnant quels environnements de travail autoriser avec OAuth 2.

Cet article vous a-t-il été utile ?