Motimate: Come integrare l'API pubblica di Motimate in PowerBI?

Vorresti avere sempre a disposizione dashboard e analisi aggiornate per i tuoi dati Motimate? Non cercare oltre: con la nostra API pubblica puoi inserire tutti i tuoi dati API direttamente in strumenti come PowerBI di Microsoft. Qui ti mostriamo come configurarlo! ✨

Prima di proseguire, assicurati che il tuo MotiSpace abbia abilitato l'API pubblica. In caso contrario, scopri di più qui.

Generare un token di accesso in Postman

• Apri Postman ed effettua una chiamata API POST all 'endpoint di autenticazione per ottenere un token.
   
• Copia il token generato per utilizzarlo temporaneamente in PowerBI.

Ora usa il token di accesso per recuperare i dati in PowerBI

• Apri Power BI e clicca su Ottieni dati --> Seleziona Web --> Clicca su Connetti.
  
  
   
• Nella finestra della connessione web, seleziona Avanzate.
   
• Incolla l'URL API dell'origine dati
  , ad esempio https://motimateapp.com/public_api/my_organization.
   
• Nella sezione Intestazioni, aggiungi:
  • Chiave: Autorizzazione
  • Valore: "Bearer <<Token generato da Postman>>".
    
    
     
• Clicca su OK per procedere.

L'editor di Power Query si aprirà e mostrerà i dati recuperati.

Creare una query per generare i token dinamicamente

Poiché i token dell'API pubblica di Motimate scadono dopo 24 ore, PowerBI deve generare dinamicamente un nuovo token prima di ogni chiamata API per garantire che il token sia sempre valido. Per configurarlo, segui i seguenti passaggi:

• Nell'Editor di Power Query, clicca su Nuova fonte --> Query vuota.
  
  
  
  
• Una volta aperta la query vuota, accedi all'Editor avanzato di .
  
  
  
  
• Inserisci la seguente query di Power Query M e sostituisci il testo in grassetto con le tue credenziali:
  
  

  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
  
  

• Clicca su Fatto.
  
   
• Verifica i passaggi applicati per confermare la generazione di un token:
  
  

Convertire la query in una funzione

• Ora rinomina la query in "GetToken".
  
  
   
• Clicca con il tasto destro del mouse su GetToken e apri l'Editor Avanzato
  
  
  
   
• Modifica la query aggiungendo "() =>" all'inizio (prima di "let"). Questo convertirà la query in una funzione.
  
  
   
• Clicca su Fatto.

Sostituisci il token di accesso codificato con la funzione

• Apri la query del dataset principale nell'Editor avanzato.
  
  
   
• Trova il token codificato nella sezione "Intestazioni" e sostituisci il token stesso con la funzione GetToken(). Ora dovrebbe essere così:
  
  Authorization = "Bearer"&GetToken()
  (assicurati di lasciare uno spazio tra la parola Bearer e la virgoletta, come mostrato sopra)
  
  
   
• Clicca su Fatto.
• Infine, clicca su Chiudi & Applica.
  
  

Congratulazioni! Hai impostato un report in PowerBI con una logica di token dinamici 🎉

Ora PowerBI genererà dinamicamente un token prima di ogni chiamata API, garantendo aggiornamenti dei dati senza interruzioni e senza interventi manuali. Questo approccio semplifica il recupero dei dati e migliora l'automazione.