Khalibre LMS 測試 (預覽版)
Khalibre 是 Khalibre 平台的提供商,被 Crosswired 和其他協作和能力建設門戶使用。 我們是一家社會企業,於 2010 年在新加坡和柬埔寨成立,為全球大中型組織提供商業技術解決方案、能力建設和學習平台。 使用 Khalibre LMS 連接器,您可以透過 API 與您選擇的系統整合來擴展 LMS 功能。
此連接器適用於以下產品和區域:
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - Azure Government 區域 - Azure 中國區域 - 美國國防部 (DoD) |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| Power Automate(自動化服務) | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 連絡人 | |
|---|---|
| 名稱 | Khalibre 支持 |
| URL | https://www.khalibre.com/contact-us |
| contact@khalibre.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 哈利伯 |
| 網站 | https://www.khalibre.com/ |
| 隱私策略 | https://www.khalibre.com/privacy-policy |
| 類別 | 生產力;通敵 |
Khalibre LMS 連接器
Khalibre 是 Khalibre 平台的提供商,被 Crosswired 和其他協作和能力建設門戶使用。 我們是一家社會企業,於 2010 年在新加坡和柬埔寨成立,為全球大中型組織提供商業技術解決方案、能力建設和學習平台。 使用 Khalibre LMS 連接器,您可以透過 API 與您選擇的系統整合來擴展 LMS 功能。 此連接器可讓您管理組織在 Khalibre 平台中發佈的課程。 您可以為學習者預約組織已發佈的課程,並查詢其進度。 您還可以查看平台中發布的可用課程和詳細的課程信息。
先決條件
您將需要以下內容才能繼續:
- Khalibre 平台帳號
- 您的組織啟用學習管理系統的 API 整合
- 為安全 API 整合產生的 OAuth 2.0 認證
如何取得 OAuth 2.0 認證
以組織管理員身分登入,然後導覽至組織 設定>API 整合。 在 OAuth 2.0 認證區 段下,您可以取得用戶端 ID 和密碼。 您也可以刪除認證或產生新認證。
支援的觸發程式
使用 當 收到 HTTP 請求作為 觸發程序時,您可以提供 Khalibre 平台將傳送觸發程序的端點,以執行下列作業:
- 課程已建立 (事件類型:course.created)
- 課程狀態會從草稿變更為公開。
- 課程更新(事件類型:course.updated)
- 課程資訊已更新。
- 課程已刪除 (事件類型:course.deleted)
- 課程狀態從公開變更為草稿。
- 課程狀態從公開變更為存檔。
- 課程已刪除。
- 社群更新(活動類型:community.updated)
- 社群名稱已更新。
- 課程共用 (事件類型:course.shared)
- 社群管理員將共享課程新增至社群。
- 課程未共用 (事件類型:course.unshared)
- 共用課程會從社群中移除。
- 課程進度狀態 (事件類型:course.status)
- 學習者取得進度,課程狀態已變更。
- 課程進度活動(事件類型:course.activity)
- 學習者取得進展並完成新的課程活動。
您可以透過組織 設定>API 整合將端點註冊到 Khalibre 平台。 在 Webhook 區段下,啟用 Webhook 並將端點提供給 Webhook URL 欄位。 當有任何與課程相關的事件時,Khalibre 平台將向此 URL 發布 HTTP。
支援的動作
-
Read courses:傳回所有可見度設定為 API 的組織課程。 -
Read course detail:傳回指定課程 ID 的課程詳細資料。 -
Progress by course ID:傳回指定課程ID的所有學習者進度。 -
Progress by email:傳回指定學習者電子郵件地址的所有學習者進度。 -
Book course:將學習者預約給定課程 ID。
注意 - 這裡的課程 ID 相當於 Khalibre 平台中的課程 ID。
您也可以透過組織設定>>取得 API 開發人員文件的連結。
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 主機名稱 | 字串 | 沒有 http/https 的主機名稱(例如:khalibre.com)。 | 對 |
| 用戶端識別碼 | 字串 | OAuth2 認證的用戶端識別碼。 | 對 |
| 客戶端密碼 | securestring | OAuth2 認證的用戶端密碼。 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 按課程 ID 的進度 |
依課程識別碼顯示學習者進度。 |
| 透過電子郵件進行進度 |
透過學習者電子郵件顯示學習者進度。 |
| 閱讀課程 |
閱讀組織公開的課程清單。 |
| 閱讀課程詳情 |
按課程 ID 閱讀課程詳細信息。 |
| 預訂課程 |
通過電子郵件地址為學習者預訂課程 |
按課程 ID 的進度
依課程識別碼顯示學習者進度。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
課程 ID
|
courseId | True | integer |
該組織已發佈的課程識別碼。 |
|
分頁
|
page | integer |
目前分頁 |
|
|
頁面大小
|
pageSize | integer |
每個要求要擷取的專案數。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
切面
|
facets | array of |
切面 |
|
items
|
items | array of object |
items |
|
活動逾期
|
items.activityOverdue | boolean |
活動逾期 |
|
預訂日期
|
items.bookingDate | string |
預訂日期 |
|
類別標題
|
items.classTitle | string |
類別標題 |
|
識別碼
|
items.community.id | integer |
識別碼 |
|
名稱
|
items.community.name | string |
名稱 |
|
completed活動
|
items.completedActivity | integer |
completed活動 |
|
courseId
|
items.courseId | integer |
courseId |
|
課程逾期
|
items.courseOverdue | boolean |
課程逾期 |
|
電子郵件地址
|
items.emailAddress | string |
電子郵件地址 |
|
名字
|
items.firstName | string |
名字 |
|
lastName
|
items.lastName | string |
lastName |
|
最近更新日期
|
items.recentUpdateDate | string |
最近更新日期 |
|
狀態
|
items.status | integer |
狀態 |
|
狀態說明
|
items.statusDescription | string |
狀態說明 |
|
title
|
items.title | string |
title |
|
總活動
|
items.totalActivity | integer |
總活動 |
|
最後頁
|
lastPage | integer |
最後頁 |
|
頁面
|
page | integer |
頁面 |
|
pageSize
|
pageSize | integer |
pageSize |
|
總計數
|
totalCount | integer |
總計數 |
透過電子郵件進行進度
透過學習者電子郵件顯示學習者進度。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
學習者電子郵件
|
learnerEmail | True | string |
學習者電子郵件地址。 |
|
分頁
|
page | integer |
目前分頁 |
|
|
頁面大小
|
pageSize | integer |
每個要求要擷取的專案數。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
切面
|
facets | array of |
切面 |
|
items
|
items | array of object |
items |
|
活動逾期
|
items.activityOverdue | boolean |
活動逾期 |
|
預訂日期
|
items.bookingDate | string |
預訂日期 |
|
類別標題
|
items.classTitle | string |
類別標題 |
|
識別碼
|
items.community.id | integer |
識別碼 |
|
名稱
|
items.community.name | string |
名稱 |
|
completed活動
|
items.completedActivity | integer |
completed活動 |
|
courseId
|
items.courseId | integer |
courseId |
|
課程逾期
|
items.courseOverdue | boolean |
課程逾期 |
|
電子郵件地址
|
items.emailAddress | string |
電子郵件地址 |
|
名字
|
items.firstName | string |
名字 |
|
lastName
|
items.lastName | string |
lastName |
|
最近更新日期
|
items.recentUpdateDate | string |
最近更新日期 |
|
狀態
|
items.status | integer |
狀態 |
|
狀態說明
|
items.statusDescription | string |
狀態說明 |
|
title
|
items.title | string |
title |
|
總活動
|
items.totalActivity | integer |
總活動 |
|
最後頁
|
lastPage | integer |
最後頁 |
|
頁面
|
page | integer |
頁面 |
|
pageSize
|
pageSize | integer |
pageSize |
|
總計數
|
totalCount | integer |
總計數 |
閱讀課程
閱讀組織公開的課程清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
頁面大小
|
pageSize | integer |
每個要求要擷取的專案數。 |
|
|
分頁
|
page | integer |
目前分頁 |
|
|
Keyword
|
keywords | string |
搜索關鍵字到申報者課程。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
切面
|
facets | array of string |
切面 |
|
items
|
items | array of object |
items |
|
additionalBookingNote
|
items.additionalBookingNote | string |
additionalBookingNote |
|
banner網址
|
items.bannerUrl | string |
banner網址 |
|
booking網址
|
items.bookingUrl | string |
booking網址 |
|
類別標題
|
items.classTitle | string |
類別標題 |
|
社區
|
items.communities | array of object |
社區 |
|
booking網址
|
items.communities.bookingUrl | string |
booking網址 |
|
識別碼
|
items.communities.id | integer |
識別碼 |
|
名稱
|
items.communities.name | string |
名稱 |
|
|
items.courseExpiryPeriod | integer |
課程到期期間 |
|
|
items.courseId | integer |
courseId |
|
建立日期
|
items.createdDate | string |
建立日期 |
|
貨幣
|
items.currency | string |
貨幣 |
|
|
items.dayBeforeBook | integer |
前一天預訂 |
|
|
items.dayBeforeCancel | integer |
前一天取消 |
|
Key
|
items.deliveryMethod.key | string |
Key |
|
value
|
items.deliveryMethod.value | string |
value |
|
說明
|
items.description | string |
說明 |
|
|
items.expectedDuration | integer |
預期持續時間 |
|
語言
|
items.languages | array of string |
語言 |
|
修改日期
|
items.modifiedDate | string |
修改日期 |
|
|
items.price | double |
價格 |
|
timezone
|
items.timezone | string |
timezone |
|
title
|
items.title | string |
title |
|
|
items.totalActivity | integer |
總活動 |
|
結束日期
|
items.endDate | string |
結束日期 |
|
startDate
|
items.startDate | string |
startDate |
|
|
lastPage | integer |
最後頁 |
|
|
page | integer |
頁面 |
|
|
pageSize | integer |
pageSize |
|
|
totalCount | integer |
總計數 |
閱讀課程詳情
按課程 ID 閱讀課程詳細信息。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
課程 ID
|
courseId | True | integer |
該組織已發佈的課程識別碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
additionalBookingNote
|
additionalBookingNote | string |
additionalBookingNote |
|
banner網址
|
bannerUrl | string |
banner網址 |
|
booking網址
|
bookingUrl | string |
booking網址 |
|
類別標題
|
classTitle | string |
類別標題 |
|
社區
|
communities | array of object |
社區 |
|
booking網址
|
communities.bookingUrl | string |
booking網址 |
|
識別碼
|
communities.id | integer |
識別碼 |
|
名稱
|
communities.name | string |
名稱 |
|
課程到期期間
|
courseExpiryPeriod | integer |
課程到期期間 |
|
courseId
|
courseId | integer |
courseId |
|
建立日期
|
createdDate | string |
建立日期 |
|
貨幣
|
currency | string |
貨幣 |
|
前一天預訂
|
dayBeforeBook | integer |
前一天預訂 |
|
前一天取消
|
dayBeforeCancel | integer |
前一天取消 |
|
Key
|
deliveryMethod.key | string |
Key |
|
value
|
deliveryMethod.value | string |
value |
|
說明
|
description | string |
說明 |
|
結束日期
|
endDate | string |
結束日期 |
|
預期持續時間
|
expectedDuration | integer |
預期持續時間 |
|
語言
|
languages | array of string |
語言 |
|
修改日期
|
modifiedDate | string |
修改日期 |
|
價格
|
price | double |
價格 |
|
startDate
|
startDate | string |
startDate |
|
timezone
|
timezone | string |
timezone |
|
title
|
title | string |
title |
|
總活動
|
totalActivity | integer |
總活動 |
預訂課程
通過電子郵件地址為學習者預訂課程
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
社區標識符
|
communityId | True | integer |
學習者將加入以存取課程的社群ID。 |
|
courseId
|
courseId | True | integer |
學習者將預訂的課程ID。 |
|
電子郵件
|
learnerEmail | True | string |
學習者電子郵件地址。 |
|
名字
|
learnerFirstname | string |
學習者名字。 |
|
|
姓氏
|
learnerLastname | string |
學習者姓氏。 |