方案
本頁譯自英文。如兩者有出入,以英文頁面為準。 閱讀英文頁面
方案是以你想做的事命名的連結。在應用程式與連結頁面按下「開始建立」後,你可以在「建立連結」下選擇一個。接著精靈會一次顯示一個步驟,每往前一步都會自動儲存,所以你可以離開後再回來。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 中顯示卡片
你的應用程式會在你的首頁或課程計畫頁面上繪製一張卡片。
- 建立:你的伺服器的登入憑證,以及 Lingara 中的卡片(應用程式資訊清單)。
- 步驟:「名稱和權限」、「你的卡片」、「檢查」、「套用」。
- 之後:Lingara 會向你在「你的應用程式繪製卡片的位置」中提供的位址要求卡片,你的應用程式則以這張卡片回應。套用後顯示的密碼中,有一個就是你的應用程式用來確認請求確實來自 Lingara 的那一個。
一個用於「你的卡片」步驟的選用腳本,它只會在首頁的側欄中顯示卡片:
return lingara.app({ client: input.client, manifest: lingara.manifest({ ...input.manifest, slots: ['home.side'] }) })