Article

Cinq étapes pour se lancer avec l’API Smartsheet

by Taylor Krusen

Les équipes informatiques en quête d’innovation qui utilisent l’API Smartsheet en constatent les bienfaits immédiatement après son intégration. Cette API est un outil performant pour les développeurs, qui assure à la fois une gestion sécurisée des données, une automatisation par « webhook » et la possibilité d’étendre Smartsheet à l’ensemble de l’entreprise.  

Vous souhaitez mettre en place une intégration avec l’API Smartsheet, mais vous ne savez pas par où commencer ? Suivez les cinq étapes détaillées ci-dessous :

1. Explorez les ressources dédiées aux développeurs

Le portail des développeurs Smartsheet réunit toutes les ressources de développement. Vous y trouverez de la documentation sur l’API, des informations sur les kits SDK proposés par Smartsheet, les réponses de notre communauté d’utilisateurs aux questions que vous vous posez sur votre API, et plus encore.

Même s’il est tentant de se lancer tête baissée dans la mise en œuvre de l’intégration, consacrer dès le départ du temps à l’examen de ces ressources portera ses fruits par la suite. 

Où trouver des ressources sur l’API

Une fois que vous avez regardé la vidéo, consultez notre page de documentation sur l’API. Que vous envisagiez de créer une intégration qui appelle directement l’API Smartsheet ou une intégration basée sur un SDK Smartsheet, vous trouverez nombre d’informations utiles dans la documentation sur l’API. Commencez par vous familiariser avec les sections suivantes :

  • Vue d’ensemble : le contexte général pour travailler avec l’API Smartsheet

  • Premiers pas : des informations dont vous aurez besoin pour jeter les bases de votre intégration

  • Dépannage : devisez un plan pour résoudre les problèmes en cas de blocage

SDK Smartsheet

Les kits de développement logiciel (SDK) Smartsheet permettent d’accéder à l’API Smartsheet avec le langage de programmation de votre choix, sans avoir à coder de zéro. En plus des méthodes prédéfinies, chaque SDK comprend une logique de nouvelle tentative (pour les erreurs de limite de débit) et des systèmes de journalisation.

Chaque SDK respectif (C#, Java, Nœud, Python, Rubis) contient de la documentation et un exemple de feuille accessible en lecture/écriture à titre de référence.

2. Inscrivez-vous en tant que développeur (facultatif)

Après avoir exploré nos ressources pour les développeurs Smartsheet, vous devriez être à même de poser les bases de votre intégration.

Créer un compte développeur

Si vous envisagez de créer une application tierce ou un compte Smartsheet sandbox (bac à sable) dédié aux activités de développement et de test (sans affecter les données de votre compte Smartsheet de production), vous devez terminer le processus d’inscription des développeurs.

3. Générez un jeton d’accès

Capture d’écran pour accorder l’accès à Smartsheet

Ensuite, pour authentifier les demandes API par accès direct à l’API, vous aurez besoin d’un jeton d’accès API appartenant au compte Smartsheet auquel vous souhaitez accéder. Les jetons d’accès peuvent être générés par l’interface utilisateur de Smartsheet : connectez-vous simplement sur votre compte Smartsheet, puis suivez les instructions suivantes pour générer un jeton.

Si vous créez une application tierce qui mettra en œuvre un flux OAuth2 pour récupérer un jeton d’accès permettant d’accéder aux données Smartsheet au nom de l’utilisateur final, vous n’aurez pas besoin de suivre les étapes ci-dessus pour générer manuellement un jeton d’accès. Consultez plutôt les documents API pour obtenir des informations sur le développement d’applications tierces.

Si vous créez une application tierce destinée à d’autres utilisateurs, vous devrez mettre en œuvre un flux OAuth2 pour récupérer un jeton d’accès. La génération automatique (plutôt que manuelle) d’un jeton d’accès garantit que l’utilisateur dispose de son propre jeton pour accéder à ses données Smartsheet. Nous vous recommandons de consulter la section de documentation API sur le développement d’applications tierces. Pour référence, nous avons un tutoriel sur la création d’un flux OAuth Smartsheet dans Node.js.

4. Commencez à mettre en place votre intégration

Le processus de création de votre intégration varie selon que vous choisissiez ou non d’utiliser un SDK. Les deux approches sont les suivantes :

Avec un SDK

Pour utiliser un SDK comme base de votre intégration, installez le SDK de votre choix en suivant les instructions fournies pour le kit SDK concerné. Ensuite, tirez parti de la documentation sur l’API pour obtenir des exemples de code et suivez ces étapes :

  1. À l’aide du panneau d’exemple de code situé à droite de la page, sélectionnez l’onglet correspondant au langage qui vous intéresse.

  2. Passez en revue le fichier readme et l’exemple de SDK en lecture/écriture concernés. Tous les liens sont disponibles sur le portail des développeurs Smartsheet.

  3. Naviguez jusqu’à n’importe quelle section dédiée aux références API pour voir un exemple de code montrant comment exécuter l’opération avec le SDK.

Sans SDK

Si l’utilisation d’un SDK peut s’avérer pratique, elle n’est en aucun cas obligatoire. Si vous préférez plutôt créer une intégration personnalisée en partant de zéro, inspirez-vous en premier lieu de la documentation sur l’API. En cas de blocage, n’hésitez pas à poser des questions sur StackOverflow à l’aide de la balise smartsheet-api. Votre question pourrait aider quelqu’un à l’avenir.

5. Demandez de l’aide à Smartsheet

Peut-être rencontrerez-vous un problème d’API ou de SDK non mentionné dans nos conseils de dépannage de l’API, ou que vous ne reconnaitrez pas votre situation dans les documents API. Dans ce cas, publiez votre problème ou votre question sur StackOverflow, où nous (ainsi que des milliers de développeurs du monde entier) sommes prêts à vous aider.

Avez-vous des commentaires sur l’API ou souhaitez-vous suggérer de nouvelles fonctionnalités ? Veuillez nous contacter à l’adresse DevRel@smartsheet.com.

Découvrir plus de ressources

L’utilisation d’une nouvelle API demande d’en apprendre beaucoup en peu de temps, mais s’aider de ressources et de processus appropriés peut faire toute la différence.

Nous vous encourageons à tirer le meilleur parti du portail des développeurs Smartsheet pour bénéficier des ressources et des conseils qui y sont présentés. Leur but : vous permettre de vous familiariser rapidement avec l’API Smartsheet et de déployer votre solution en toute confiance.  

Abonnez-vous à la newsletter informatique de Smartsheet pour obtenir des conseils, des stratégies et des idées visant à aider les professionnels concernés à jouer un rôle déterminant pour l’entreprise.