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 開發者文件列出腳本可以調用嘅所有嘢。
• 連接建立嘅所有嘢，你都可以喺網頁版嘅開發者工具度自己手動建立。