Dans le monde professionnel d’aujourd’hui, connecter vos outils devient indispensable. Power Platform vous aide à construire des solutions automatisées, mais comment récupérer des informations depuis des services externes ? C’est exactement ce que permettent les API REST grâce aux connecteurs personnalisés. Cette technologie transforme des systèmes isolés en un écosystème connecté. Vous pouvez créer vos propres ponts vers n’importe quelle application, même celles absentes du catalogue Microsoft.
En bref
- Les connecteurs personnalisés permettent d’intégrer n’importe quelle API externe dans Power Platform
- Plusieurs méthodes d’authentification sont disponibles : clé API, OAuth 2.0 ou authentification basique
- La création passe par la définition des actions, paramètres et réponses attendues de l’API
- Les connecteurs fonctionnent à la fois dans Power Automate et Power Apps pour automatiser ou afficher des données
- Les bonnes pratiques incluent la gestion des quotas, la mise en cache et le partage des connecteurs certifiés avec votre équipe
Comprendre les API REST
Les API REST représentent un moyen standard pour faire communiquer différentes applications entre elles sur internet. REST signifie Representational State Transfer, mais ce terme technique cache une réalité simple : ces interfaces permettent d’échanger des données entre systèmes informatiques.
Quand vous utilisez Power Platform, vous avez souvent besoin de récupérer des informations depuis d’autres services. Les API REST fonctionnent avec des requêtes HTTP classiques, exactement comme votre navigateur web.
Chaque API possède des points d’entrée appelés endpoints. Vous envoyez une demande à une adresse spécifique, et le serveur vous renvoie des données, généralement au format JSON.
Les connecteurs personnalisés dans Power Platform
Power Platform propose plusieurs centaines de connecteurs prêts à l’emploi. Mais parfois, vous devez accéder à une API qui n’existe pas dans le catalogue standard.
C’est là qu’interviennent les connecteurs personnalisés. Ils vous permettent de créer votre propre pont vers n’importe quelle API REST externe.
La création d’un connecteur personnalisé se fait directement depuis Power Automate ou Power Apps. L’interface vous guide pas à pas dans la configuration.
Méthodes d’authentification disponibles
L’authentification garantit que seules les personnes autorisées accèdent aux données. Power Platform supporte plusieurs méthodes pour sécuriser vos connexions API.
La clé API constitue la méthode la plus simple. Vous recevez une chaîne de caractères unique que vous ajoutez à chaque requête. Cette approche convient parfaitement aux APIs simples.
OAuth 2.0 offre un niveau de sécurité supérieur. Cette méthode demande une autorisation explicite de l’utilisateur avant d’accéder à ses données. Microsoft l’utilise pour ses propres services.
L’authentification basique avec nom d’utilisateur et mot de passe reste disponible, même si nous conseillons de privilégier des alternatives plus sécurisées quand c’est possible.
Créer votre premier connecteur personnalisé
Commencez par rassembler la documentation de l’API que vous souhaitez connecter. Vous aurez besoin de l’URL de base, des endpoints disponibles et du type d’authentification requis.
Rendez-vous dans Power Automate, puis dans la section Données et sélectionnez Connecteurs personnalisés. Cliquez sur Nouveau connecteur personnalisé et choisissez Créer entièrement.
Remplissez les informations générales : nom du connecteur, description et URL d’hôte de l’API. Cette URL de base sera utilisée pour toutes vos requêtes.
Configurez ensuite la sécurité en sélectionnant le type d’authentification approprié. Suivez les instructions spécifiques à votre API pour compléter cette étape correctement.
Définir les actions et déclencheurs
Les actions représentent ce que votre connecteur peut faire. Chaque action correspond à un appel vers un endpoint spécifique de l’API.
Pour ajouter une action, cliquez sur Nouvelle action et renseignez les détails : nom, description, méthode HTTP (GET, POST, PUT, DELETE) et chemin de l’endpoint.
Définissez les paramètres nécessaires. Certains paramètres peuvent être obligatoires, d’autres optionnels. Spécifiez leur type : texte, nombre, date ou booléen.
Les déclencheurs fonctionnent différemment. Ils lancent automatiquement un flux quand un événement se produit dans le système externe. Toutes les APIs ne supportent pas cette fonctionnalité.
Gérer les réponses et les erreurs
Une fois votre requête envoyée, l’API renvoie une réponse. Vous devez indiquer à Power Platform comment interpréter ces données.
Dans la section Réponse de votre action, ajoutez une réponse par défaut. Collez un exemple de réponse JSON fourni par la documentation de l’API. Power Platform analysera automatiquement la structure.
Les codes d’état HTTP vous renseignent sur le résultat de la requête. Le code 200 signale une réussite, tandis que 404 indique que la ressource demandée n’existe pas.
Prévoyez la gestion des erreurs dans vos flux. Ajoutez des actions conditionnelles pour traiter les échecs et informer les utilisateurs en cas de problème.
Tester votre connecteur
Avant d’utiliser votre connecteur en production, testez-le minutieusement. Power Platform intègre des outils de test directement dans l’interface de création.
Créez une connexion de test en fournissant les identifiants nécessaires. Sélectionnez ensuite une action et remplissez les paramètres requis avec des valeurs réelles.
Lancez le test et examinez la réponse. Vérifiez que les données reçues correspondent à vos attentes et que tous les champs sont correctement mappés.
Si des erreurs apparaissent, consultez les messages détaillés. Ils indiquent généralement la source du problème : paramètre manquant, format incorrect ou problème d’authentification.
Utiliser votre connecteur dans Power Automate
Une fois validé, votre connecteur apparaît dans la liste des connecteurs disponibles lors de la création d’un flux. Recherchez-le par son nom dans la barre de recherche.
Ajoutez une action basée sur votre connecteur personnalisé. Remplissez les paramètres requis, soit avec des valeurs fixes, soit avec des données dynamiques provenant d’étapes précédentes.
Les données récupérées deviennent disponibles pour les étapes suivantes de votre flux. Utilisez-les pour enrichir vos processus métier ou synchroniser des informations entre systèmes.
Intégrer des API dans Power Apps
Les connecteurs personnalisés fonctionnent également dans Power Apps. Cela vous permet d’afficher des données externes directement dans vos applications.
Ajoutez votre connecteur comme source de données dans votre application. Les actions définies deviennent des fonctions utilisables dans vos formules Power Fx.
Appelez ces fonctions depuis vos contrôles : boutons, galeries ou formulaires. Les données récupérées s’affichent instantanément dans votre interface utilisateur.
Attention à la fréquence des appels API. Trop de requêtes simultanées peuvent ralentir votre application ou atteindre les limites de l’API externe.
Bonnes pratiques et optimisation
Documentez systématiquement vos connecteurs personnalisés. Notez les paramètres attendus, les formats de données et les cas d’usage prévus. Vos collègues vous remercieront.
Gérez intelligemment les appels API pour respecter les quotas. Beaucoup d’APIs limitent le nombre de requêtes autorisées par heure ou par jour.
Voici quelques recommandations pour optimiser vos connexions :
- Mettez en cache les données qui changent rarement pour réduire les appels inutiles
- Regroupez plusieurs opérations en une seule requête quand l’API le permet
- Utilisez des filtres pour récupérer uniquement les données nécessaires
- Implémentez une logique de nouvelle tentative en cas d’échec temporaire
Surveillez les performances de vos connecteurs. Power Platform fournit des statistiques sur l’utilisation et les temps de réponse. Ces métriques vous aident à identifier les goulots d’étranglement.
Partager vos connecteurs avec l’équipe
Les connecteurs personnalisés peuvent être partagés au sein de votre organisation. Cela évite que chaque personne ne recrée le même connecteur de son côté.
Demandez la certification de vos connecteurs auprès de votre administrateur. Une fois certifiés, ils deviennent disponibles pour tous les utilisateurs autorisés de votre tenant.
Maintenez vos connecteurs à jour quand l’API externe évolue. Les modifications de l’API peuvent casser vos flux existants si vous ne les adaptez pas rapidement.
FAQ
Quelle est la différence entre un connecteur standard et un connecteur personnalisé dans Power Platform ?
Un connecteur standard fait partie du catalogue officiel de Power Platform avec plusieurs centaines d’options prêtes à l’emploi pour des services populaires. Un connecteur personnalisé, en revanche, vous permet de créer votre propre pont vers n’importe quelle API REST externe qui n’existe pas dans le catalogue standard.
Combien de temps faut-il pour créer un connecteur personnalisé ?
Le temps nécessaire pour créer un connecteur personnalisé varie selon la complexité de l’API. Pour une API simple avec une clé API et quelques endpoints, comptez 30 minutes à 1 heure. Les APIs complexes avec OAuth 2.0 et de nombreuses actions peuvent nécessiter plusieurs heures de configuration et de tests.
Peut-on modifier un connecteur personnalisé après sa création ?
Oui, un connecteur personnalisé peut être modifié après sa création. Vous pouvez ajouter de nouvelles actions, modifier les paramètres existants ou ajuster l’authentification. Toutefois, maintenez vos connecteurs à jour quand l’API externe évolue, car les modifications peuvent casser vos flux existants si vous ne les adaptez pas rapidement.
Quels sont les principaux codes d’état HTTP à connaître pour gérer les erreurs ?
Les principaux codes d’état HTTP à connaître incluent : 200 pour une réussite, 404 quand la ressource n’existe pas, 401 pour une erreur d’authentification, 403 pour un accès interdit, 500 pour une erreur serveur et 429 quand vous dépassez les limites de requêtes autorisées par l’API.
Un connecteur personnalisé fonctionne-t-il avec tous les produits Power Platform ?
Un connecteur personnalisé fonctionne avec Power Automate et Power Apps comme expliqué dans l’article. Il est également compatible avec Power BI et Power Virtual Agents, ce qui permet une utilisation cohérente à travers l’ensemble de Power Platform pour vos intégrations API.