方案
這頁係對英文翻譯過來个。若係兩片無共樣,以英文頁為準。 看英文頁
方案係用你想愛做个事情來安名个連接。在應用程式同連接頁面㧡「開始建立」以後,你就做得在「建立一隻連接」下背揀一隻。接下來精靈一擺顯示一隻步驟,你每行一步都會儲存,所以你做得先離開再轉來。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'] }) })