Lingara Lingara 說明文件 學習指南 API 函式庫 App 建立 網頁版
語言: 客家話

方案

這頁係對英文翻譯過來个。若係兩片無共樣,以英文頁為準。 看英文頁

方案係用你想愛做个事情來安名个連接。在應用程式同連接頁面㧡「開始建立」以後,你就做得在「建立一隻連接」下背揀一隻。接下來精靈一擺顯示一隻步驟,你每行一步都會儲存,所以你做得先離開再轉來。App 無顯示分你看个方案,就係你个帳戶還吂做得用。

每隻方案都係用共樣个兩隻步驟收尾:「檢查」摎「套用」。測試、演練同套用會解釋這兩隻步驟。

分𠊎个伺服器呼叫 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 肚背顯示一張卡

你个 App 會在你个首頁抑係課程計畫頁面畫一張卡。

  • 建立:你个伺服器个登入,還有 Lingara 肚背个一張卡(App 清單)。
  • 步驟:「名稱同能力」、「你个卡」、「檢查」、「套用」。
  • 以後:Lingara 會向你在「你个 App 畫卡个位所」分个地址討卡,你个 App 就用該張卡回應。套用以後顯示个密碼肚項,有一隻就係你个 App 用來確認請求真个係 Lingara 傳來个。

一隻用在「你个卡」步驟、做得揀个腳本,佢淨在首頁个側邊欄顯示卡:

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

另外看