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
- L’API ClickUp est disponible avec tous les forfaits ClickUp.
- Un propriétaire ou administrateur d’environnement de travail devra créer une application dans votre environnement de travail ClickUp.
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 :
- Dans le coin supérieur droit, cliquez sur votre avatar personnel.
- Sélectionnez Paramètres.
- Dans la barre latérale, cliquez sur API ClickUp.
- Cliquez sur + Créer une application.
- Saisissez le nom de votre application et une ou plusieurs URL de redirection.
Si vous ne savez pas quoi utiliser comme URL de redirection, lisez ce guide sur le site Web d’OAuth. - Cliquez sur Créer l’application.
- Sur l’écran suivant s’affichent un identifiant client et un secret client.
- Utilisez l’identifiant client et le secret client pour créer un flux d’authentification OAuth 2 dans votre appli.
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 :
- Dans le coin supérieur droit, cliquez sur votre avatar personnel.
- Sélectionnez Paramètres.
- Dans la barre latérale, cliquez sur API ClickUp.
- Cliquez sur une application existante pour afficher ses détails.
- Mettez à jour l’URL de redirection.
- Cliquez sur Enregistrer.
Afficher votre secret client ou en générer un nouveau
Pour générer votre nouveau secret client :
- Dans le coin supérieur droit, cliquez sur votre avatar personnel.
- Sélectionnez Paramètres.
- Dans la barre latérale, cliquez sur API ClickUp.
- Cliquez sur une application existante pour afficher ses détails.
- Cliquez sur Afficher pour visualiser votre secret client actuel.
- Cliquez sur Régénérer pour créer un nouveau secret client.
- 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.