Motimate: Wie lässt sich die öffentliche API von Motimate in PowerBI integrieren?

Wünschst du dir, dass du immer aktuelle Dashboards und Analysen für deine Motimate-Daten hast? Mit unserer öffentlichen API kannst du alle deine API-Daten direkt in Tools wie PowerBI von Microsoft übertragen. Hier zeigen wir dir, wie du das einrichten kannst! ✨

Bevor du weitermachst, stelle sicher, dass in deinem MotiSpace die öffentliche API aktiviert ist. Wenn nicht, erfährst du mehr hier.

Ein Zugriffstoken in Postman generieren

• Öffne Postman und führe einen POST-API-Aufruf an den Authentifizierungsendpunkt durch, um ein Token zu erhalten.
   
• Kopiere das generierte Token zur vorübergehenden Verwendung in PowerBI.

Verwende nun das Access Token, um Daten in PowerBI abzurufen

• Öffne Power BI und klicke auf Daten abrufen --> Wähle Web --> Klicke auf Verbinden.
  
  
   
• Wähle im Fenster Webverbindung die Option Erweitert.
   
• Füge die API-URL der Datenquelle
  ein, also https://motimateapp.com/public_api/my_organization.
   
• Füge im Abschnitt "Überschriften" hinzu:
  • Schlüssel: Autorisierung
  • Wert: "Bearer <<Token generiert von Postman>>"
    
    
     
• Klicke auf OK, um fortzufahren.

Der Power Query Editor wird geöffnet und zeigt die abgerufenen Daten an.

Eine Abfrage erstellen, um Token dynamisch zu erzeugen

Da Motimate Public API-Tokens nach 24 Stunden ablaufen, muss PowerBI vor jedem API-Aufruf dynamisch ein neues Token generieren, um sicherzustellen, dass das Token immer gültig ist. Das kannst du mit den folgenden Schritten einrichten:

• Klicke im Power Query Editor auf Neue Quelle --> Leere Abfrage.
  
  
  
  
• Sobald die leere Abfrage geöffnet ist, gehst du zum Advanced Editor.
  
  
  
  
• Gib die folgende Power Query M-Abfrage ein und ersetze den fettgedruckten Text durch deine eigenen Anmeldedaten:
  
  

  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
  
  

• Klicke auf Fertig.
  
   
• Überprüfe die angewandten Schritte, um zu bestätigen, dass ein Token erzeugt wird:
  
  

Konvertiere die Abfrage in eine Funktion

• Benenne die Abfrage nun in "GetToken" um.
  
  
   
• Klicke mit der rechten Maustaste auf GetToken und öffne den erweiterten Editor
  
  
  
   
• Ändere die Abfrage, indem du "() =>" am Anfang (vor "let") hinzufügst. Dadurch wird die Abfrage in eine Funktion umgewandelt.
  
  
   
• Klicke auf Fertig.

Ersetze das hartcodierte Zugriffstoken durch die Funktion

• Öffne die Hauptabfrage des Datensatzes im erweiterten Editor.
  
  
   
• Finde das hartkodierte Token im Abschnitt "Header" und ersetze das Token selbst mit der Funktion GetToken(). Sie sollte nun wie folgt aussehen:
  
  Authorization = "Bearer "&GetToken()
  (Achte darauf, dass du ein Leerzeichen zwischen dem Wort Bearer und dem Anführungszeichen am Ende lässt, wie oben gezeigt)
  
  
   
• Klicke auf Fertig.
• Klicke abschließend auf Schließen & Übernehmen.
  
  

Herzlichen Glückwunsch! Du hast einen Bericht in PowerBI mit einer dynamischen Token-Logik eingerichtet 🎉.

Jetzt generiert PowerBI vor jedem API-Aufruf dynamisch ein Token und sorgt so für nahtlose Datenaktualisierungen ohne manuelle Eingriffe. Dieser Ansatz vereinfacht das Abrufen von Daten und verbessert die Automatisierung.