考試數(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": "會計基礎考試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": "會計基礎考試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

當前頁碼

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": "會計基礎考試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

當前頁碼

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不存在,獲取失敗"}

獲取考生待參加考試

獲取考生待參加考試列表信息。如在第三方應用或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": "會計基礎考試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": "會計基礎考試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

當前頁碼

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:[賬號]在考試云中不存在"}