考試數(shù)據(jù)
1、獲取考試信息
2、獲取考試成績
3、獲取考生待參加考試
獲取考試信息
獲取考試信息列表,如考試基本信息、考試時間、及格分/總分、參加人次、最值成績、考試入口等。
接口地址: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小時內(nèi)有效,請注意時效性  | 
action  | getExamList  | 
pageIndex  | 分頁頁碼,默認第1頁  | 
pageSize  | 每頁條數(shù),默認1000條  | 
返回值說明:
1、執(zhí)行成功
JSON返回值格式
{
  "totalCount": 60,
  "currentPageIndex": 3,
  "items": [
    {
      "examID": "d7310f",
      "examName": "會計基礎(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": "會計基礎(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  | 考試開始時間  | 
endTime  | 考試結(jié)束時間  | 
examTime  | 答題時間(分鐘)  | 
passScore  | 通過考試分數(shù)線  | 
paperScore  | 卷面總分  | 
attendNum  | 已參加人次  | 
passNum  | 通過考試人次  | 
maxScore  | 最好成績  | 
avgScore  | 平均成績  | 
minScore  | 最差成績  | 
createTime  | 創(chuàng)建時間  | 
examURL  | 考試入口鏈接  | 
2、執(zhí)行失敗,返回值
{"errcode":"40006","errmsg":"AccessToken has expired"}獲取考試成績
獲取某個考試的所有成績信息,如考生信息、答題開始/結(jié)束時間、用時、成績、排名等信息。
接口地址: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小時內(nèi)有效,請注意時效性  | 
action  | getExamGrade  | 
examID  | 考試編號  | 
pageIndex  | 分頁頁碼,默認第1頁  | 
pageSize  | 每頁條數(shù),默認1000條  | 
返回值說明:
1、執(zhí)行成功
JSON返回值格式
{
  "examID": "b1e8ef",
  "examName": "會計基礎(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ù),默認1000條  | 
currentPageIndex  | 當(dāng)前頁碼  | 
account  | 考生賬號  | 
userName  | 考生姓名  | 
deptName  | 所屬部門  | 
fullDeptName  | 部門全路徑  | 
beginTime  | 考試開始時間  | 
endTime  | 考試結(jié)束時間  | 
usedTime  | 答題時間  | 
passScore  | 及格分數(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小時內(nèi)有效,請注意時效性  | 
action  | getUserExam  | 
account  | 考生賬號  | 
pageIndex  | 分頁頁碼,默認第1頁  | 
pageSize  | 每頁條數(shù),默認10條  | 
返回值說明:
1、執(zhí)行成功
JSON返回值格式
{
  "totalCount": 2,
  "currentPageIndex": 1,
  "items": [
    {
      "examID": "661502",
      "examName": "會計基礎(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": "會計基礎(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  | 考試開始時間  | 
endTime  | 考試結(jié)束時間  | 
examURL  | 考試入口鏈接,點擊鏈接進入考試  | 
examTime  | 答題時間(分鐘)  | 
allowTimes  | 允許參加次數(shù)  | 
passScore  | 通過考試分數(shù)線  | 
paperScore  | 卷面總分  | 
2、執(zhí)行失敗,返回值
{"errcode":"40006","errmsg":"AccessToken has expired"}{"errcode":"40501","errmsg":"account參數(shù)不允許為空"}{"errcode":"40502","errmsg":"account:[賬號]在考試云中不存在"}