課程數(shù)據(jù)

1、獲取課程信息

2、獲取學習成績

3、獲取學員待參加課程

獲取課程信息

獲取當前學員所有待參加練習和練習入口。如在第三方應用或App中,需要展示考試云待參加練習列表。

接口地址:https://api.kaoshiyun.com.cn/api/v5/lessonaction.ashx?token=[Token]&action=getLessonList&pageIndex=[pageIndex]&pageSize=[pageSize]

請求方式:GET或POST

參數(shù)說明:

參數(shù)名稱

說明

token

接口調(diào)用憑證,2小時內(nèi)有效,請注意時效性

action

getLessonList

pageIndex

分頁頁碼,默認第1

pageSize

每頁條數(shù),默認1000

返回值說明:

1、執(zhí)行成功

JSON返回值格式

{
  "totalCount": 2,
  "currentPageIndex": 1,
  "items": [
    {
      "lessonID": "8bf058",
      "lessonName": "第一季度崗位培訓在線課程",
      "beginTime": "2022-01-11 17:17",
      "endTime": "2022-04-01 17:17",
      "passCondition": "達到課程學時",
      "attendNum": "4",
      "passNum": "2",
      "unPassNum": "2",
      "creatTime": "2021-07-25 17:17:34",
      "lessonUrl": "https://課程地址/v5/lesson/8bf058"
    },
    {
      "lessonID": "06a1ad",
      "lessonName": "第二季度崗位培訓在線課程 ",
      "beginTime": "2022-04-24 15:05",
      "endTime": "2022-07-01 15:05",
      "passCondition": "通過課程考試",
      "attendNum": "9",
      "passNum": "0",
      "unPassNum": "9",
      "creatTime": "2022-03-24 15:06:41",
      "lessonUrl": "https://課程地址/v5/lesson/06a1ad"
    }
  ]
}

返回值參數(shù)說明

參數(shù)名稱

說明

totalCount

總記錄數(shù)

currentPageIndex

當前頁碼

lessonID

課程編號

lessonName

課程名稱

beginTime

課程開始時間

endTime

課程結(jié)束時間

passCondition

課程通過條件

attendNum

參加課程人數(shù)

passNum

通過課程人數(shù)

unPassNum

未通過課程人數(shù)

lessonURL

學習入口鏈接,點擊鏈接進入課程學習

2、執(zhí)行失敗,返回值

{"errcode":"40006","errmsg":"AccessToken has expired"}
{"errcode":"40501","errmsg":"account參數(shù)不允許為空"}
{"errcode":"40502","errmsg":"account:[賬號]在考試云中不存在"}


獲取學習成績

獲取某個課程的所有學習成績,如學習記錄、學習時間、次數(shù)、學時、成績、學分、狀態(tài)等信息。

接口地址:https://api.kaoshiyun.com.cn/api/v5/lessongrade.ashx?token=[Token]&action=getLessonGrade&lessonID=[examid]&pageIndex=[pageIndex]&pageSize=[pageSize]

請求方式:GET或POST

參數(shù)說明:

參數(shù)名稱

說明

token

接口調(diào)用憑證,2小時內(nèi)有效,請注意時效性

action

getLessonGrade

lessonID

課程編號

pageIndex

分頁頁碼,默認第1頁

pageSize

每頁條數(shù),默認1000條


返回值說明:

1、執(zhí)行成功

JSON返回值格式

{
  "lessonID": "b1e8ef",
  "lessonName": "第一季度在線培訓課程",
  "totalCount": 750,
  "pageSize": 1000,
  "currentPageIndex": 1,
  "items": [
    {
      "account": "c089d6",
      "userName": "陳翰林",
      "deptName": "銷售部",
      "fullDeptName": "考試云/銷售中心/銷售部",
      "gradeID": "dc3d4020622b46a0bf82d8fa1e38bc00",
      "beginTime": "2022-04-25 13:03:03",
      "endTime": "2022-04-28 13:33:07",
      "learnedTime": "210分4秒",
      "learnedCount": "5",
      "gradeScore": "80.0",
      "isPass": "Y",
      "integral": "10",
      "finishPercent": "100%",
      "statusCode": "finished",
      "status": "已完成"
    },
    {
      "account": "c089d6",
      "userName": "李一鳴",
      "deptName": "技術(shù)部",
      "fullDeptName": "考試云/研發(fā)中心/開發(fā)部",
      "gradeID": "28e4bea1f2904c15814d0b6cca39457d",
      "beginTime": "2022-04-25 13:01:50",
      "endTime": "2022-04-29 13:54:53",
      "learnedTime": "53分3秒",
      "learnedCount": "2",
      "gradeScore": "-",
      "isPass": "-",
      "integral": "10",
      "finishPercent": "40%",
      "statusCode": "progress",
      "status": "學習中"
    }
  ]
}

返回值參數(shù)說明:

參數(shù)名稱

說明

lessonID

課程編號

lessonName

課程名稱

totalCount

總記錄數(shù)

pageSize

每頁條數(shù),默認1000

currentPageIndex

當前頁碼

account

考生賬號

userName

考生姓名

deptName

所屬部門

fullDeptName

部門全路徑

beginTime

學習開始時間

endTime

學習結(jié)束時間

learnedTime

學習時長

learnedCount

學習次數(shù)

gradeScore

考試成績(如果有設定課程考試)

isPass

是否通過考試,Y為通過,N為未通過.

integral

所得積分

finishPercent

課程學習進度

integral

所得積分

status

課程學習狀態(tài):

nostart 未學習

progress 學習中

examing 待考試

examfailed未通過考試

finished已完成

unfinished 未完成

2、執(zhí)行失敗,返回值

{"errcode":"40006","errmsg":"AccessToken has expired"}
{"errcode":"40902","errmsg":"lessonID不存在,獲取失敗"}
{"errcode":"40903","errmsg":"課程參加方式為非賬號密碼,獲取失敗"}


獲取學員待參加課程

獲取當前學員待參加練習和練習入口。如在第三方應用或App中,需要展示考試云待參加練習列表。

接口地址:https://api.kaoshiyun.com.cn/api/v5/lessonaction.ashx?token=[Token]&action=getUserLesson&account=[account]&pageIndex=[pageIndex]&pageSize=[pageSize]

請求方式:GET或POST

參數(shù)說明:

參數(shù)名稱

說明

token

接口調(diào)用憑證,2小時內(nèi)有效,請注意時效性

action

getUserLesson

account

考生(學員)賬號

pageIndex

分頁頁碼,默認第1頁

pageSize

每頁條數(shù),默認10條

返回值說明:

1、執(zhí)行成功

JSON返回值格式

{
  "totalCount": 2,
  "currentPageIndex": 1,
  "items": [
    {
      "lessonID": "8bf058",
      "lessonName": "第一季度崗位培訓在線課程",
      "beginTime": "2022-01-11 17:17",
      "endTime": "2022-03-01 17:17",
      "passCondition": "達到課程學時",
      "lessonUrl": "https://學習鏈接/v5/lesson/8bf058"
    },
    {
      "lessonID": "06a1ad",
      "lessonName": "第二季度崗位培訓在線課程",
      "beginTime": "2022-03-24 15:05",
      "endTime": "2022-06-01 15:05",
      "passCondition": "通過課程考試",
      "lessonUrl": "https://學習鏈接/v5/lesson/06a1ad"
    }
  ]
}

返回值參數(shù)說明

參數(shù)名稱

說明

totalCount

總記錄數(shù)

currentPageIndex

當前頁碼

lessonID

課程編號

lessonName

課程名稱

beginTime

課程開始時間

endTime

課程結(jié)束時間

passCondition

課程通過條件

lessonURL

學習入口鏈接,點擊鏈接進入課程學習

2、執(zhí)行失敗,返回值

{"errcode":"40006","errmsg":"AccessToken has expired"}
{"errcode":"40501","errmsg":"account參數(shù)不允許為空"}
{"errcode":"40502","errmsg":"account:[賬號]在考試云中不存在"}