Motimate: Як інтегрувати Motimate Public API до PowerBI?

Бажаєте завжди мати доступ до актуальних дашбордів та аналітики для ваших даних Motimate в реальному часі? Більше нічого не потрібно шукати - за допомогою нашого публічного API ви можете отримувати всі дані API безпосередньо в такі інструменти, як PowerBI від Microsoft. Тут ми покажемо вам, як це налаштувати! ✨

Перш ніж продовжити, переконайтеся, що у вашому MotiSpace увімкнено публічний API. Якщо ні, дізнайтеся більше тут.

Згенеруйте маркер доступу у Postman

• Відкрийте Postman і зробіть виклик POST API до кінцевої точки автентифікації, щоб отримати токен.
   
• Скопіюйте згенерований токен для тимчасового використання в PowerBI.

Тепер використовуйте маркер доступу для отримання даних в PowerBI

• Відкрийте Power BI і натисніть " Отримати дані" --> Виберіть " Веб" --> Натисніть " Підключити".
  
  
   
• У вікні Веб-з'єднання виберіть Додатково.
   
• Вставте URL-адресу API джерела даних
  , тобто https://motimateapp.com/public_api/my_organization
   
• У розділі "Заголовки" додайте:
  • Ключ: Авторизація
  • Значення: "Пред'явник <<Токен згенерований з Postman>>"
    
    
     
• Натисніть OK, щоб продовжити.

Відкриється редактор Power Query Editor, в якому відобразяться отримані дані.

Створення запиту для динамічної генерації токенів

Оскільки термін дії токенів Motimate Public API закінчується через 24 години, PowerBI повинен динамічно генерувати новий токен перед кожним викликом API, щоб гарантувати, що токен завжди дійсний. Це можна налаштувати, виконавши такі кроки:

• У редакторі запитів Power Query виберіть Нове джерело -> Порожній запит.
  
  
  
  
• Після того, як відкриється порожній запит, перейдіть до розширеного редактора .
  
  
  
  
• Введіть наступний запит Power Query M і замініть виділений жирним шрифтом текст своїми обліковими даними:
  
  

  let
  url ="https://motimateapp.com/public_api/oauth/token",
  headers = [#"Content-Type" = "application/json"],
  postData = Json.FromValue([
  
  client_id="<<ваш ідентифікатор клієнта>>", 
  client_secret="<<ваш секрет клієнта>>", 
  grant_type="client_credentials"
  
  ]),
  response = Web.Contents(
  url,
  [
  Headers = headers,
  Content = postData
  ]
  ),
  Data = Json.Document(response),
  access_token = Data[access_token]
  в
  access_token
  
  

• Натисни "Готово".
  
   
• Перевірте застосовані кроки, щоб підтвердити, що токен генерується:
  
  

Перетворення запиту на функцію

• Тепер перейменуйте запит на "GetToken".
  
  
   
• Клацніть правою кнопкою миші на GetToken і відкрийте розширений редактор
  
  
  
   
• Змініть запит, додавши "() =>" на початку (перед "let"). Це перетворить запит у функцію.
  
  
   
• Натисни "Готово".

Замініть Жорстко закодований токен доступу на функцію

• Відкрийте основний запит до набору даних у Розширеному редакторі.
  
  
   
• Знайдіть жорстко закодований токен у розділі "Заголовки" і замініть сам токен на функцію GetToken(). Тепер це має виглядати так:
  
  Authorization = "Bearer "&GetToken()
  (переконайтеся, що ви залишаєте пробіл між словом Bearer і лапками, як показано вище)
  
  
   
• Натисни "Готово".
• Нарешті, натисніть Закрити & Застосувати.
  
  

Вітаю! Ви налаштували звіт у PowerBI з динамічною логікою токенів 🎉.

Тепер PowerBI буде динамічно генерувати токен перед кожним викликом API, забезпечуючи безперебійне оновлення даних без ручного втручання. Такий підхід спрощує пошук даних і покращує автоматизацію.