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'] }) })

閣看