Motimate：如何使用 Motimate Public API？

使用公共 API 自動與您的資料來源進行使用者整合與同步，並將 Motimate 連接到其他超酷的服務 🔀

公共 API 是一套服務，可用於更新和管理 Motimate 中的資料。 它以標準的方式記錄，稱為 OpenAPI，並提供開發人員以程式化的方式存取我們的軟體服務。 此 API 擁有比 SCIM 和 CSV 更廣泛的支援，但您需要整合服務或軟體機器人才能使用。

PAPI v2 的推出，讓您從 MotiSpace 匯出資料變得比以往更輕鬆，端點包括：

• /motis/progresses
• /motis/chapter_completions
• /張貼和
• /insights/learnings/report_requests

資料模型

公共 API 提供模型以自動進行使用者配置和 Pulse 發佈。 它有這些資料模型：

• 使用者模型：您可以使用它來讀取、寫入及更新使用者帳戶的資訊。 這可能包括聯絡資訊、存取角色，以及 moti 管理的群組指派。 如果使用者有一個或多個位置，也可以在此端點中設定。
   
• 群組模型： 這可讓您讀取、寫入及指派使用者群組。 這些群組也可以樹狀結構來配合您的組織，並簡化學習作業。 
  
  重要： 目前使用屬性種類定義群組層級。 種類的 價值可能因組織而異。 您的組織管理員也可以輕鬆變更。 當設定 API 整合時，建議為您的群組層級定義永久的種類 名稱清單，以避免種類名稱變更時在 API 整合中可能發生的錯誤。
   
• 位置模型：此模型允許您讀取和寫入使用者帳戶可指定的位置。
   
• 文章：您可以使用此功能建立文章並發佈在 Pulse 上。 這可以結合檔案服務來上傳影像。
   
• 檔案：此服務用於上傳 Pulse 帖子的圖片。 影像的大小限制為 40 MB，視訊為 100 MB，文件為 100 MB。
   
• 洞察力：此服務用於產生並獲得客製化報告的連結。 報告範本必須事先在 Motimate 平台中使用「Insights」下的「Generate Reports」功能建立。

驗證

OAuth 令牌端點 用於建立存取令牌。 請聯絡support@motimateapp.com 取得您的client_id和client_secret 。

收到這些詳細資料後，就可以程式化或透過Postman 等平台產生代用幣。 您只需傳送 API 呼叫至 POST /oauth/tokens endpoint並將您從Motimate Support收到的client_id和client_secret認證作為JSON體。

API 會回應一個獨特的 token，有效期為 24 小時。 您可以根據需要產生任意數量的代幣。 在您對所有其他端點的請求中，該標記應該作為 Bearer 標記傳給 Authorization 標頭 ("Bearer "+[your_token])。

範例：
"Bearer eyJhbkyFjHk0oIY6ghkkgRI1NiJ9.eyJ0b23Lo7G5jk7mJkYzdiZD"
 

您可以使用 GET /me 端點 來驗證存取標記。 如果您有一個 keystore 來保存您的存取標記，而且您想要驗證它是否正常運作，而不需要調用任何交易呼叫，這個功能就很有用。