Lingara 入門

本頁譯自英文。如兩者有出入，以英文頁面為準。 閱讀英文頁面

不必從零撰寫整合，就能把你自己的伺服器或應用程式連結到你的 Lingara 帳戶。你選擇一個方案，填寫幾個欄位，依照 Lingara 的真實規則檢查結果，然後套用它。腳本是選用的。

你可以打造什麼

一個連結由四個構成要素組成。下面每一個都以 App 裡的說法命名，旁邊是 Lingara 對它使用的術語：

• 你的伺服器的登入憑證（OAuth 用戶端）。你的伺服器用它代表你的帳戶執行操作。
• 該登入憑證的密碼（用戶端密鑰）。它只會顯示一次，就在套用之後。
• 傳送到你的伺服器的訊息（Webhook 端點）。發生某件事時，例如課程計畫準備好時，Lingara 會傳送一則訊息給你的伺服器。
• Lingara 中的卡片（應用程式資訊清單）。你的應用程式會在你的首頁或課程計畫頁面上繪製一張卡片。

你永遠不必手動把它們組合起來。方案會選好構成要素和順序，而「開始檢查」會在建立任何內容之前告訴你將建立什麼。

課程計畫準備好時通知我的伺服器

這個方案會建立一個登入憑證、它的密碼以及訊息。從網頁版開始，並依照精靈上的文字操作：

1. 在應用程式與連結頁面的「建立連結」下，按下「開始建立」，然後選擇「課程計畫準備好時通知我的伺服器」。
2. 在「名稱和權限」中，為登入憑證命名。
3. 在「傳送到哪裡」中，填入你的伺服器的 https:// 位址。你也可以開啟「使用腳本」，貼上下面的腳本，然後按下「試執行」。
4. 在「檢查」中，按下「開始檢查」，並閱讀「將建立以下內容」。
5. 按下「套用」，並在每個密碼出現時複製它。每個密碼只會顯示一次。
6. 產生一份課程計畫，看著你的伺服器收到 lesson_plan.ready。

腳本是選用的。這個腳本做的事情和欄位相同，並另外加上課程計畫無法產生時 Lingara 傳送的訊息：

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

接下來

• 方案介紹全部三個方案，以及如何使用每個方案建立的內容。
• 測試、演練與套用說明「開始檢查」會檢查什麼，以及「套用」會做什麼。
• Lingara 開發者文件列出腳本可以呼叫的所有內容。
• 連結建立的一切，你也可以在網頁版的開發者工具中手動建立。