Lingara 入门

本页译自英文。如两者有出入，以英文页面为准。 阅读英文页面

无需从零编写集成，就能把你自己的服务器或应用连接到你的 Lingara 账户。你选择一个方案，填写几个字段，按照 Lingara 的真实规则检查结果，然后应用它。脚本是可选的。

你可以构建什么

一个连接由四个构建块组成。下面每一个都用应用里的说法命名，旁边是 Lingara 对它使用的术语：

• 你的服务器的登录凭据（OAuth 客户端）。你的服务器用它代表你的账户执行操作。
• 该登录凭据的密码（客户端密钥）。它只显示一次，就在应用之后。
• 发送到你的服务器的消息（Webhook 端点）。发生某件事时，例如课程计划准备好时，Lingara 会给你的服务器发送一条消息。
• Lingara 中的卡片（应用清单）。你的应用在你的首页或课程计划页面上绘制一张卡片。

你永远不必手动把它们组合起来。方案会选好构建块及其顺序，而“开始检查”会在创建任何内容之前告诉你将会创建什么。

课程计划准备好时通知我的服务器

此方案会创建一个登录凭据、它的密码以及消息。从网页应用开始，按照向导中的文字操作：

1. 在应用与连接页面的“创建连接”下，点击“开始创建”，然后选择“课程计划准备好时通知我的服务器”。
2. 在“名称和权限”中，为登录凭据命名。
3. 在“发送到哪里”中，填写你的服务器的 https:// 地址。你也可以打开“使用脚本”，粘贴下面的脚本，然后点击“试运行”。
4. 在“检查”中，点击“开始检查”，并阅读“将创建以下内容”。
5. 点击“应用”，并在每个密码出现时复制它。每个密码只显示一次。
6. 生成一个课程计划，看着你的服务器收到 lesson_plan.ready。

脚本是可选的。这个脚本完成的事情与字段相同，并额外加上课程计划无法生成时 Lingara 发送的消息：

return lingara.webhook({ client: input.client, url: input.url, events: ['lesson_plan.ready', 'lesson_plan.failed'] })

接下来

• 方案介绍全部三个方案，以及如何使用每个方案创建的内容。
• 测试、演练与应用解释“开始检查”检查什么，以及“应用”做什么。
• Lingara 开发者文档列出脚本可以调用的全部内容。
• 连接创建的一切，你也可以在网页应用的开发者工具中手动创建。