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

1、獲取課程信息

2、獲取學(xué)習(xí)成績

3、獲取學(xué)員待參加課程

獲取課程信息

獲取當(dāng)前學(xué)員所有待參加練習(xí)和練習(xí)入口。如在第三方應(yīng)用或App中,需要展示考試云待參加練習(xí)列表。

接口地址: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

分頁頁碼,默認(rèn)第1

pageSize

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

返回值說明:

1、執(zhí)行成功

JSON返回值格式

{
  "totalCount": 2,
  "currentPageIndex": 1,
  "items": [
    {
      "lessonID": "8bf058",
      "lessonName": "第一季度崗位培訓(xùn)在線課程",
      "beginTime": "2022-01-11 17:17",
      "endTime": "2022-04-01 17:17",
      "passCondition": "達(dá)到課程學(xué)時",
      "attendNum": "4",
      "passNum": "2",
      "unPassNum": "2",
      "creatTime": "2021-07-25 17:17:34",
      "lessonUrl": "https://課程地址/v5/lesson/8bf058"
    },
    {
      "lessonID": "06a1ad",
      "lessonName": "第二季度崗位培訓(xùn)在線課程 ",
      "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

當(dāng)前頁碼

lessonID

課程編號

lessonName

課程名稱

beginTime

課程開始時間

endTime

課程結(jié)束時間

passCondition

課程通過條件

attendNum

參加課程人數(shù)

passNum

通過課程人數(shù)

unPassNum

未通過課程人數(shù)

lessonURL

學(xué)習(xí)入口鏈接,點(diǎn)擊鏈接進(jìn)入課程學(xué)習(xí)

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

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


獲取學(xué)習(xí)成績

獲取某個課程的所有學(xué)習(xí)成績,如學(xué)習(xí)記錄、學(xué)習(xí)時間、次數(shù)、學(xué)時、成績、學(xué)分、狀態(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

分頁頁碼,默認(rèn)第1頁

pageSize

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


返回值說明:

1、執(zhí)行成功

JSON返回值格式

{
  "lessonID": "b1e8ef",
  "lessonName": "第一季度在線培訓(xùn)課程",
  "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": "學(xué)習(xí)中"
    }
  ]
}

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

參數(shù)名稱

說明

lessonID

課程編號

lessonName

課程名稱

totalCount

總記錄數(shù)

pageSize

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

currentPageIndex

當(dāng)前頁碼

account

考生賬號

userName

考生姓名

deptName

所屬部門

fullDeptName

部門全路徑

beginTime

學(xué)習(xí)開始時間

endTime

學(xué)習(xí)結(jié)束時間

learnedTime

學(xué)習(xí)時長

learnedCount

學(xué)習(xí)次數(shù)

gradeScore

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

isPass

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

integral

所得積分

finishPercent

課程學(xué)習(xí)進(jìn)度

integral

所得積分

status

課程學(xué)習(xí)狀態(tài):

nostart 未學(xué)習(xí)

progress 學(xué)習(xí)中

examing 待考試

examfailed未通過考試

finished已完成

unfinished 未完成

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

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


獲取學(xué)員待參加課程

獲取當(dāng)前學(xué)員待參加練習(xí)和練習(xí)入口。如在第三方應(yīng)用或App中,需要展示考試云待參加練習(xí)列表。

接口地址: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

考生(學(xué)員)賬號

pageIndex

分頁頁碼,默認(rèn)第1頁

pageSize

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

返回值說明:

1、執(zhí)行成功

JSON返回值格式

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

返回值參數(shù)說明

參數(shù)名稱

說明

totalCount

總記錄數(shù)

currentPageIndex

當(dāng)前頁碼

lessonID

課程編號

lessonName

課程名稱

beginTime

課程開始時間

endTime

課程結(jié)束時間

passCondition

課程通過條件

lessonURL

學(xué)習(xí)入口鏈接,點(diǎn)擊鏈接進(jìn)入課程學(xué)習(xí)

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

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