Motimate：如何使用 Motimate 公共 API？

使用公共应用程序接口（Public API）实现用户与数据源的自动集成和同步，并将 Motimate 与其他超酷服务连接 🔀

公共 API 是一组服务，可用于更新和管理 Motimate 中的数据。 它以标准方式记录下来，称为 OpenAPI，为开发人员提供对我们软件的编程访问服务。 该应用程序接口的支持范围比 SCIM 和 CSV 更广，但需要集成服务或软件机器人才能使用。

PAPI v2 的推出使从 MotiSpace 导出数据比以往任何时候都更加容易，其终端包括

• /motis/progresses
• /motis/chapter_completions
• /帖子和
• /insights/learnings/report_requests

数据模型

公共应用程序接口提供模型，用于自动配置用户和发布脉搏。 它有这些数据模型：

• 用户模型：可用于读取、写入和更新用户账户信息。 其中可包括联系信息、访问角色和用于 moti 管理的组分配。 如果用户有一个或多个位置，也可以在该端点中进行设置。
   
• 组模型： 它允许你读取、写入和分配用户组。 这些群组还可以采用树形结构，以配合您的组织并简化学习任务。 
  
  重要信息： 组级别目前是通过属性种类来定义的。 不同组织对 "种类 "的重视程度可能不同。 组织管理员也可以轻松更改。 在设置应用程序接口集成时，建议为组级别定义一个永久的种类 名称列表，以避免在种类名称发生变化时在应用程序接口集成中可能出现的错误。
   
• 位置模型：该模型允许读写可分配给用户账户的位置。
   
• 帖子：您可以用它来创建帖子并在 Pulse 上发布。 这可以与上传图片的文件服务结合使用。
   
• 文件：这项服务用于为 Pulse Posts 上传图片。 图片的大小限制为 40 MB，视频为 100 MB，文件为 100 MB。
   
• 洞察力：该服务用于生成和获取定制报告的链接。 报告模板必须事先在 Motimate 平台上使用 "洞察 "下的 "生成报告 "功能创建。

认证

OAuth 令牌端点 用于创建访问令牌。 请联系support@motimateapp.com 获取您的client_id和client_secret 。

收到这些详细信息后，就可以通过编程或Postman 等平台生成令牌。 你只需发送一个 API 调用到 POST /oauth/tokens 端点的 API 调用，并将从 Motimate Support 收到的client_id和client_secret凭证作为 JSON 主体。

应用程序接口将响应一个唯一的令牌，其有效期为 24 小时。 您可以根据需要生成任意数量的代币。 在向所有其他端点发出请求时，应将该令牌作为承载器令牌传递给授权标头（"Bearer "+[your_token]）。

例如
"承载者 eyJhbkyFjHk0oIY6ghkkgRI1NiJ9.eyJ0b23Lo7G5jk7mJkYzdiZD"
 

您可以使用 GET /me 端点 来验证访问令牌。 如果您有一个保存访问令牌的密钥存储，并希望在不调用任何事务调用的情况下验证它是否正常工作，那么这将非常有用。