Bien sûr ! Notre API exploite GraphQL. Elle vous apportera toute la flexibilité nécessaire pour accéder aux informations de votre compte monday.com et les modifier.

 

 

Pourquoi GraphQL ?

Nos utilisateurs utilisent monday.com pour gérer toutes sortes d'informations. Nous voulions créer une API aussi flexible que notre plateforme. C'est pourquoi nous avons créé une API capable de traiter des requêtes expressives pour vous permettre d'obtenir les informations dont vous avez précisément besoin, quand vous en avez besoin. Si vous souhaitez en savoir plus sur le langage de requête GraphQL, consultez graphql.org. 😄 

 

Documentation et tests

Pour faciliter l'utilisation de notre API, nous avons rédigé cette documentation qui présente les requêtes et les mutations que vous pouvez effectuer sur vos données. Vous pouvez également tester vos requêtes juste ici, dans notre explorateur GraphQL. 

 

Authentification avec votre jeton d'API

Toute requête envoyée à notre API doit être accompagnée d'un jeton d'API afin de confirmer votre identité. 😊

 

API pour les utilisateurs admins

Chaque admin du compte dispose de son propre jeton d'API. Veillez à le sécuriser ! Pour générer votre jeton d'API : 

1. Connectez-vous à votre compte monday.com.
2. Cliquez sur votre avatar dans le coin supérieur droit de votre écran.
3. Sélectionnez « Administration ».
4. Cliquez « Connexions » dans le panneau de gauche de la page Admin. 
5. Sélectionnez « API » dans le menu du haut. 
6. Cliquez sur le bouton « Copier » à droite de la clé API de la personne. Vous devriez voir un écran similaire à celui-ci :

 

API pour les utilisateurs non admins

Si vous n'êtes pas admin de votre compte monday.com, vous pouvez obtenir vos jetons d'API dans la section Développeurs, en suivant ces étapes :

1. Connectez-vous à votre compte monday.com.
2. Cliquez sur votre avatar dans le coin supérieur droit de votre écran.
3. Sélectionnez « Développeurs ».
4. Cliquez sur « Développeur », puis sur « Mes jetons d'accès » en haut de la page. 
5. Lorsque vous sélectionnez « Afficher » à côté de la clé API, cela vous permet également de la copier. 

Vous pouvez utiliser ce jeton d'API pour authentifier toutes vos requêtes à notre API, ainsi que dans notre environnement de test. Au besoin, vous pouvez de nouveau générer ce jeton à tout moment, mais sachez que cela fera expirer l'ancien. 

 

Jetons d'API générés via OAuth

Vous avez également la possibilité d'utiliser le flux d'autorisation OAuth pour générer un jeton pour des applications spécifiques. Les autorisations de ces jetons sont limitées et dépendent des étendues d'autorisation des applications auxquelles ils sont reliés. Pour en savoir plus, consultez notre documentation sur OAuth.

 

Autorisations de jeton d'API

Les autorisations du jeton d'API d'un utilisateur sont limitées aux autorisations de l'utilisateur lui-même. 

Par exemple, si l'utilisateur a accès en lecture seule uniquement à un tableau quelconque, le jeton d'API ne pourra pas mettre à jour les informations de ce tableau. 

De même, si un utilisateur n'a pas accès à un tableau privé, les applications qui utilisent son jeton d'API n'auront pas accès à ce tableau non plus. 

 

Accéder à notre API GraphQL

Nous savons que nos utilisateurs aiment tester les choses avant de les implémenter, c'est pourquoi nous avons intégré un éditeur de requêtes à notre plateforme. Vous pouvez l'utiliser pour tester des requêtes et des mutations avant de les implémenter dans votre application. Pour utiliser l'explorateur d'API, cliquez sur ce lien.

Une fois sur la page de l'explorateur, saisissez votre jeton d'API dans le champ prévu : 

Vous entrerez ensuite dans notre environnement de test. Dans le panneau de gauche de l'explorateur, saisissez votre requête ou votre mutation. Appuyez ensuite sur le bouton « Lecture » en haut à gauche pour afficher vos résultats dans le panneau de droite. 

Vous pouvez également cliquer sur le bouton « Docs » en haut à droite de l'explorateur pour accéder directement à notre documentation. Pour y accéder en dehors de l'explorateur, cliquez sur ce lien.

 

Envoyer des requêtes

Vous avez testé vos requêtes et vous êtes prêt à les envoyer directement depuis votre application ? Vous êtes au bon endroit ! 😊

Toutes les requêtes adressées à notre serveur doivent être des requêtes POST envoyées à api.monday.com/v2. 

Veillez à utiliser le type de contenu « application/json » et à indiquer votre clé API comme paramètre « Autorisation » dans les en-têtes :

{
    "Content-Type" : "application/json",
    "Authorization" : "mySuperSecretAPIKey"
}

Votre requête et vos variables sont transmises dans le corps de la requête. Il devrait ressembler à ceci :

{ 
    "query" : "...",
    "variables" : {"myVariable" : "foo", "yourVariable" : "bar"}
}  

 

Collection Facteur

Nous avons rassemblé des exemples des demandes d'API les plus courantes dans une collection Postman. Vous pouvez l'utiliser pour tester des exemples de requêtes avec notre API et générer des extraits de code à copier dans votre application. Lisez ces exemples pour tester vos propres demandes.

Pourquoi utiliser l'API ?

Vous ne savez pas si vous devez utiliser l'API ou non ? L'API permet aux applications personnalisées d'accéder à monday work OS, afin que vous puissiez connecter vos propres scripts, intégrations et outils à vos processus de travail. Si cela vous intéresse, l'API est faite pour vous.

Vous pouvez utiliser l'API de nombreuses façons pour optimiser vos processus de travail. Voici quelques exemples :

• Connexion à des intégrations de données tierces
• Configurer des outils d'intégration sans code comme Zapier pour construire des flux de données personnalisés
• Importation et exportation de données par lots
• Utiliser l'API comme couche de données pour les applications personnalisées de monday afin de se connecter à monday

Pour aller plus loin

La plateforme monday contient également des outils permettant de créer des applications intégrées à vos processus de travail - telles que des vues de tableaux, des intégrations, et plus encore.

Si vous avez besoin d'encore plus d'options pour améliorer vos processus de travail, vous pouvez utiliser la structure des apps par monday pour créer des applications sur mesure répondant à des besoins spécifiques au sein de votre espace de travail. Pour en savoir plus, consultez notre documentation sur le Framework d'applications et plongez dans nos exemples.

Limites de taux

Les limites applicables au taux d’API dépendent du niveau de complexité, qui est limité à 10 000 000 par minute et par compte. Pour en savoir plus, cliquez ici.

 

Codez bien !

Maintenant que vous maîtrisez les bases de l'envoi de requêtes à notre API, consultez notre documentation API pour approfondir vos connaissances. Vous pouvez également vous amuser avec notre environnement de test.

Pour finir, consultez nos tutoriels de démarrage rapide dans différents langages de programmation :

• Tutoriel de démarrage rapide pour l'API - Javascript
• Tutoriel de démarrage rapide pour l'API - PHP
• Tutoriel de démarrage rapide pour l'API - Python

 

 

 

Si vous avez la moindre question, n'hésitez pas à contacter notre équipe ici. Nous sommes disponibles 24h/​24, 7j/​7 et sommes toujours heureux de vous aider.