方案
呢頁係由英文翻譯過嚟嘅。如果兩個版本有出入,以英文頁為準。 睇英文頁
方案係一個用你想做嘅嘢嚟命名嘅連接。喺應用程式同連接頁面㩒咗「開始建立」之後,你就可以喺「建立連接」下面揀一個。跟住精靈會一次顯示一個步驟,你每行一步都會儲存,所以你可以走開咗再返嚟。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'] }) })