Motimate : Comment intégrer l'API publique de Motimate à PowerBI ?

Vous souhaitez disposer en permanence de tableaux de bord et d'analyses actualisés pour vos données Motimate ? Ne cherchez plus - avec notre API publique, vous pouvez obtenir toutes vos données d'API directement dans des outils tels que PowerBI de Microsoft. Nous vous montrons ici comment procéder ! ✨

Avant d'aller plus loin, assurez-vous que l'API publique est activée sur votre MotiSpace. Si ce n'est pas le cas, vous pouvez en savoir plus ici.

Générer un jeton d'accès dans Postman

• Ouvrez Postman et faites un appel API POST au point de terminaison d'authentification pour obtenir un jeton.
   
• Copiez le jeton généré pour une utilisation temporaire dans PowerBI.

Utilisez maintenant le jeton d'accès pour récupérer des données dans PowerBI

• Ouvrez Power BI et cliquez sur Get Data --> Sélectionnez Web --> Cliquez sur Connect.
  
  
   
• Dans la fenêtre Connexion Web, sélectionnez Avancé.
   
• Collez l'URL de l'API de la source de données
  , c'est-à-dire https://motimateapp.com/public_api/my_organization.
   
• Dans la section En-têtes, ajoutez :
  • Clé : Autorisation
  • Valeur : "Porteur <<Token généré par Postman>>"
    
    
     
• Cliquez sur OK pour continuer.

L'éditeur Power Query s'ouvre et affiche les données récupérées.

Créer une requête pour générer des jetons de manière dynamique

Comme les jetons de l'API publique de Motimate expirent après 24 heures, PowerBI doit générer dynamiquement un nouveau jeton avant chaque appel à l'API pour s'assurer que le jeton est toujours valide. Pour ce faire, il suffit de suivre les étapes suivantes :

• Dans l'éditeur de Power Query, cliquez sur Nouvelle source --> Requête vierge.
  
  
  
  
• Une fois la requête vierge ouverte, accédez à l'éditeur avancé de .
  
  
  
  
• Saisissez la requête Power Query M suivante et remplacez le texte en gras par vos propres informations d'identification :
  
  

  let
  url ="https://motimateapp.com/public_api/oauth/token",
  headers = [#"Content-Type" = "application/json"],
  postData = Json.FromValue([
  
  client_id="<<your client ID>>", 
  client_secret="<<your client secret>>", 
  grant_type="client_credentials"
  
  ]),
  response = Web.Contents(
  url,
  [
  Headers = headers,
  Content = postData
  ]
  ),
  Data = Json.Document(response),
  access_token = Data[access_token]
  in
  access_token
  
  

• Clique sur Done.
  
   
• Vérifiez les étapes appliquées pour confirmer qu'un jeton est généré :
  
  

Convertir la requête en fonction

• Renommez maintenant la requête en "GetToken".
  
  
   
• Cliquez avec le bouton droit de la souris sur GetToken et ouvrez l'éditeur avancé.
  
  
  
   
• Modifiez la requête en ajoutant "() =>" au début (avant "let"). Cette opération convertit la requête en une fonction.
  
  
   
• Clique sur Done.

Remplacer le jeton d'accès codé en dur par la fonction

• Ouvrez la requête du jeu de données principal dans l'éditeur avancé.
  
  
   
• Trouvez le jeton codé en dur dans la section "Headers" et remplacez le jeton lui-même par la fonction GetToken(). Il devrait maintenant ressembler à ceci :
  
  Authorization = "Bearer "&GetToken()
  (assurez-vous de laisser un espace entre le mot Bearer et le guillemet de fin, comme indiqué ci-dessus)
  
  
   
• Clique sur Done.
• Enfin, cliquez sur Fermer & Appliquer.
  
  

Félicitations ! Vous avez configuré un rapport dans PowerBI avec une logique de jeton dynamique 🎉.

Désormais, PowerBI génère dynamiquement un jeton avant chaque appel à l'API, garantissant ainsi des mises à jour de données transparentes sans intervention manuelle. Cette approche simplifie la recherche de données et améliore l'automatisation.