Lingara Lingara 文档 学习指南 API 库 应用 构建 网页版
语言: 中文简体

方案

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

方案是以你想做的事情命名的连接。在应用与连接页面点击“开始创建”后,你可以在“创建连接”下选择一个。随后向导会一次显示一个步骤,每前进一步都会自动保存,所以你可以离开后再回来。应用中没有向你显示的方案,表示你的账户暂时还不能使用它。

每个方案都以相同的两个步骤结束:“检查”和“应用”。测试、演练与应用介绍了这两个步骤。

让我的服务器调用 Lingara

你的服务器获得自己的登录凭据和密码,从而可以代表你使用 Lingara。

  • 创建:你的服务器的登录凭据(OAuth 客户端),以及该登录凭据的密码(客户端密钥)。
  • 步骤:“名称和权限”、“检查”、“应用”。
  • 之后:你的服务器用该登录凭据及其密码登录,然后以你在“它可以做什么”中授予它的权限调用 Lingara。

一个用于登录凭据步骤的可选脚本,它保留你输入的名称,并把它标记为你的服务器所用:

return lingara.client({ name: input.name + ' (server)', scopes: input.scopes })

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

每当你的某个课程计划准备好时,Lingara 都会给你的服务器发送一条消息。

  • 创建:你的服务器的登录凭据、该登录凭据的密码,以及发送到你的服务器的消息(Webhook 端点)。
  • 步骤:“名称和权限”、“发送到哪里”、“检查”、“应用”。
  • 之后:你的服务器会收到 lesson_plan.ready,它发送到你提供的 https:// 地址。每条消息都经过签名:应用后显示的密码中,有一个就是你的服务器用来确认消息确实来自 Lingara 的那个。

一个用于“发送到哪里”步骤的可选脚本,它还会请求课程计划无法生成时发送的消息:

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

在 Lingara 中显示卡片

你的应用在你的首页或课程计划页面上绘制一张卡片。

  • 创建:你的服务器的登录凭据,以及 Lingara 中的卡片(应用清单)。
  • 步骤:“名称和权限”、“你的卡片”、“检查”、“应用”。
  • 之后:Lingara 会向你在“你的应用绘制卡片的位置”中提供的地址请求卡片,你的应用则以这张卡片作答。应用后显示的密码中,有一个就是你的应用用来确认请求确实来自 Lingara 的那个。

一个用于“你的卡片”步骤的可选脚本,它只在首页的侧栏中显示卡片:

return lingara.app({ client: input.client, manifest: lingara.manifest({ ...input.manifest, slots: ['home.side'] }) })

另请参阅