Lingara 入門
這頁是對英文翻譯過來的。若兩篇無仝,以英文頁為準。 看英文頁
免對零開始寫整合,就會當共你家己的伺服器抑是應用程式連結去你的 Lingara 帳戶。你揀一个方案,填幾个欄位,用 Lingara 真正的規則檢查結果,才共伊套用。腳本是會使選擇的。
你會當起造啥物
一个連結是四種組件組成的。下跤逐種攏用應用程式內底的講法號名,邊仔是 Lingara 對伊用的術語:
- 你的伺服器的登入(OAuth 用戶端)。你的伺服器用伊替你的帳戶做代誌。
- 彼个登入的密碼(用戶端密鑰)。伊干焦顯示一擺,就佇套用了後。
- 傳予你的伺服器的訊息(Webhook 端點)。有代誌發生的時,親像課程計畫準備好矣,Lingara 就會傳一个訊息予你的伺服器。
- Lingara 內底的一張卡片(應用程式資訊清單)。你的應用程式會佇你的首頁抑是課程計畫頁面畫一張卡片。
你永遠免家己動手共個鬥做伙。方案會揀好組件佮順序,而且「檢查」會佇建立任何物件進前共你講會建立啥物。
課程計畫準備好的時通知我的伺服器
這个方案會建立一个登入、伊的密碼佮訊息。對網頁版開始,綴精靈頂懸的字來做:
- 佇應用程式佮連結頁面的「起造一个連結」下跤,揤「開始起造」,才揀「課程計畫準備好的時通知我的伺服器」。
- 佇「名稱佮能力」,共登入號一个名。
- 佇「欲傳去佗位」,填你的伺服器的
https://地址。你嘛會使拍開「用腳本」,貼下跤的腳本,才揤「試看覓」。 - 佇「檢查」,揤「檢查」,閣讀「這是會建立的物件」。
- 揤「套用」,逐个密碼一出現就共伊複製。逐个密碼干焦顯示一擺。
- 產生一份課程計畫,看你的伺服器收著
lesson_plan.ready。
腳本是會使選擇的。這个腳本做的代誌佮欄位仝款,閣加上課程計畫做袂成的時 Lingara 傳的訊息:
return lingara.webhook({ client: input.client, url: input.url, events: ['lesson_plan.ready', 'lesson_plan.failed'] })
紲落來
- 方案介紹全部三个方案,閣有逐个方案建立的物件欲按怎用。
- 測試、演練佮套用解說「檢查」會檢查啥物,閣有「套用」會做啥物。
- Lingara 開發者文件列出腳本會當呼叫的所有物件。
- 連結建立的一切,你嘛會使佇網頁版的開發者工具內底家己手動建立。
閣看
參考
- Lingara 開發者文件
步驟腳本呼叫的 lingara.v1 API、腳本會當做啥物,閣有 v1 干焦會擴充的承諾。