考試數(shù)據(jù)

1、獲取考試信息

2、獲取考試成績

3、獲取考生待參加考試

獲取考試信息

獲取考試信息列表,如考試基本信息、考試時(shí)間、及格分/總分、參加人次、最值成績、考試入口等。

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

請求方式:GET或POST

參數(shù)說明:

參數(shù)名稱

說明

token

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

action

getExamList

pageIndex

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

pageSize

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


返回值說明:

1、執(zhí)行成功

JSON返回值格式

{
  "totalCount": 60,
  "currentPageIndex": 3,
  "items": [
    {
      "examID": "d7310f",
      "examName": "會計(jì)基礎(chǔ)考試A卷",
      "beginTime": "2022-03-18 17:12",
      "endTime": "2022-07-13 17:12",
      "examTime": "60",
      "passScore": "60",
      "paperScore": "100",
      "attendNum": "650",
      "passNum": "628",
      "maxScore": "100.0",
      "avgScore": "39.8",
      "minScore": "0.0",
      "creatTime": "2022-03-18 17:12:22",
      "examUrl": "https://考試網(wǎng)址/v5/exam/d7310f"
    },
    {
      "examID": "91c510",
      "examName": "會計(jì)基礎(chǔ)考試B卷",
      "beginTime": "2022-03-17 15:05",
      "endTime": "2022-07-20 15:05",
      "examTime": "60",
      "passScore": "80.00",
      "paperScore": "100.00",
      "attendNum": "300",
      "passNum": "252",
      "maxScore": "80.00",
      "avgScore": "40.00",
      "minScore": "0.00",
      "creatTime": "2022-03-17 15:05:45",
      "examUrl": "https://考試網(wǎng)址/v5/exam/91c510"
    }
  ]
}

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

參數(shù)名稱

說明

totalCount

總記錄數(shù)

currentPageIndex

當(dāng)前頁碼

examID

考試編號

beginTime

考試開始時(shí)間

endTime

考試結(jié)束時(shí)間

examTime

答題時(shí)間(分鐘)

passScore

通過考試分?jǐn)?shù)線

paperScore

卷面總分

attendNum

已參加人次

passNum

通過考試人次

maxScore

最好成績

avgScore

平均成績

minScore

最差成績

createTime

創(chuàng)建時(shí)間

examURL

考試入口鏈接


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

{"errcode":"40006","errmsg":"AccessToken has expired"}


獲取考試成績

獲取某個(gè)考試的所有成績信息,如考生信息、答題開始/結(jié)束時(shí)間、用時(shí)、成績、排名等信息。

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

請求方式:GET或POST

參數(shù)說明:

參數(shù)名稱

說明

token

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

action

getExamGrade

examID

考試編號

pageIndex

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

pageSize

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


返回值說明:

1、執(zhí)行成功

JSON返回值格式

{
  "examID": "b1e8ef",
  "examName": "會計(jì)基礎(chǔ)考試A卷",
  "totalCount": 590,
  "pageSize": 1000,
  "currentPageIndex": 1,
  "items": [
    {
      "account": "c089d6",
      "userName": "陳翰林",
      "deptName": "銷售部",
      "fullDeptName": "考試云/銷售中心/銷售部",
      "gradeID": "dc3d4020622b46a0bf82d8fa1e38bc00",
      "beginTime": "2022-04-25 13:03:03",
      "endTime": "2022-04-25 13:33:07",
      "usedTime": "30分4秒",
      "paperScore": "100.0",
      "passScore": "80.0",
      "gradeScore": "75.0",
      "order": "82",
      "isPass": "N",
      "integral": "7.5",
      "status": "已發(fā)布"
    },
    {
      "account": "c089d6",
      "userName": "李一鳴",
      "deptName": "技術(shù)部",
      "fullDeptName": "考試云/研發(fā)中心/開發(fā)部",
      "gradeID": "28e4bea1f2904c15814d0b6cca39457d",
      "beginTime": "2022-04-25 13:01:50",
      "endTime": "2022-04-25 13:54:53",
      "usedTime": "53分3秒",
      "paperScore": "100.0",
      "passScore": "60.0",
      "gradeScore": "100.0",
      "order": "1",
      "isPass": "Y",
      "integral": "10",
      "status": "已發(fā)布"
    }
  ]
}

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

參數(shù)名稱

說明

examID

考試編號

examName

考試名稱

totalCount

總記錄數(shù)

pageSize

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

currentPageIndex

當(dāng)前頁碼

account

考生賬號

userName

考生姓名

deptName

所屬部門

fullDeptName

部門全路徑

beginTime

考試開始時(shí)間

endTime

考試結(jié)束時(shí)間

usedTime

答題時(shí)間

passScore

及格分?jǐn)?shù)線

paperScore

卷面總分

gradeScore

考試成績

order

排名

isPass

是否通過考試,Y為通過,N為不通過

integral

所得積分

status

成績狀態(tài)

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

{"errcode":"40006","errmsg":"AccessToken has expired"}
{"errcode":"40803","errmsg":"examID不存在,獲取失敗"}

獲取考生待參加考試

獲取考生待參加考試列表信息。如在第三方應(yīng)用或App中,需要展示考試云待參加考試列表。

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

請求方式:GET或POST

參數(shù)說明:

參數(shù)名稱

說明

token

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

action

getUserExam

account

考生賬號

pageIndex

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

pageSize

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


返回值說明:

1、執(zhí)行成功

JSON返回值格式

{
  "totalCount": 2,
  "currentPageIndex": 1,
  "items": [
    {
      "examID": "661502",
      "examName": "會計(jì)基礎(chǔ)考試A卷",
      "beginTime": "2021-04-25 09:30",
      "endTime": "2021-05-02 09:30",
      "examUrl": "https://考試網(wǎng)址/v5/exam/661502",
      "examTime": "60",
      "allowTimes": "4",
      "passScore": "80",
      "paperScore": "100"
    },
    {
      "examID": "d7310f",
      "examName": "會計(jì)基礎(chǔ)考試B卷",
      "beginTime": "2021-03-18 17:12",
      "endTime": "2021-07-13 17:12",
      "examUrl": "https://考試網(wǎng)址/v5/exam/d7310f",
      "examTime": "60",
      "allowTimes": "100",
      "passScore": "80",
      "paperScore": "100"
    }
  ]
}

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

參數(shù)名稱

說明

totalCount

總記錄數(shù)

currentPageIndex

當(dāng)前頁碼

examID

考試編號

beginTime

考試開始時(shí)間

endTime

考試結(jié)束時(shí)間

examURL

考試入口鏈接,點(diǎn)擊鏈接進(jìn)入考試

examTime

答題時(shí)間(分鐘)

allowTimes

允許參加次數(shù)

passScore

通過考試分?jǐn)?shù)線

paperScore

卷面總分


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

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