考試數(shù)據(jù)
1、獲取考試信息
2、獲取考試成績(jī)
3、獲取考生待參加考試
獲取考試信息
獲取考試信息列表,如考試基本信息、考試時(shí)間、及格分/總分、參加人次、最值成績(jī)、考試入口等。
接口地址:https://api.kaoshiyun.com.cn/api/v5/examaction.ashx?token=[Token]&action=getExamList&pageIndex=[pageIndex]&pageSize=[pageSize]
請(qǐng)求方式:GET或POST
參數(shù)說(shuō)明:
參數(shù)名稱(chēng) | 說(shuō)明 |
token | 接口調(diào)用憑證,2小時(shí)內(nèi)有效,請(qǐng)注意時(shí)效性 |
action | getExamList |
pageIndex | 分頁(yè)頁(yè)碼,默認(rèn)第1頁(yè) |
pageSize | 每頁(yè)條數(shù),默認(rèn)1000條 |
返回值說(shuō)明:
1、執(zhí)行成功
JSON返回值格式
{
"totalCount": 60,
"currentPageIndex": 3,
"items": [
{
"examID": "d7310f",
"examName": "會(huì)計(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": "會(huì)計(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ù)說(shuō)明:
參數(shù)名稱(chēng) | 說(shuō)明 |
totalCount | 總記錄數(shù) |
currentPageIndex | 當(dāng)前頁(yè)碼 |
examID | 考試編號(hào) |
beginTime | 考試開(kāi)始時(shí)間 |
endTime | 考試結(jié)束時(shí)間 |
examTime | 答題時(shí)間(分鐘) |
passScore | 通過(guò)考試分?jǐn)?shù)線(xiàn) |
paperScore | 卷面總分 |
attendNum | 已參加人次 |
passNum | 通過(guò)考試人次 |
maxScore | 最好成績(jī) |
avgScore | 平均成績(jī) |
minScore | 最差成績(jī) |
createTime | 創(chuàng)建時(shí)間 |
examURL | 考試入口鏈接 |
2、執(zhí)行失敗,返回值
{"errcode":"40006","errmsg":"AccessToken has expired"}獲取考試成績(jī)
獲取某個(gè)考試的所有成績(jī)信息,如考生信息、答題開(kāi)始/結(jié)束時(shí)間、用時(shí)、成績(jī)、排名等信息。
接口地址:https://api.kaoshiyun.com.cn/api/v5/gradeaction.ashx?token=[Token]&action=getExamGrade&examid=[examid]&pageIndex=[pageIndex]&pageSize=[pageSize]
請(qǐng)求方式:GET或POST
參數(shù)說(shuō)明:
參數(shù)名稱(chēng) | 說(shuō)明 |
token | 接口調(diào)用憑證,2小時(shí)內(nèi)有效,請(qǐng)注意時(shí)效性 |
action | getExamGrade |
examID | 考試編號(hào) |
pageIndex | 分頁(yè)頁(yè)碼,默認(rèn)第1頁(yè) |
pageSize | 每頁(yè)條數(shù),默認(rèn)1000條 |
返回值說(shuō)明:
1、執(zhí)行成功
JSON返回值格式
{
"examID": "b1e8ef",
"examName": "會(huì)計(jì)基礎(chǔ)考試A卷",
"totalCount": 590,
"pageSize": 1000,
"currentPageIndex": 1,
"items": [
{
"account": "c089d6",
"userName": "陳翰林",
"deptName": "銷(xiāo)售部",
"fullDeptName": "考試云/銷(xiāo)售中心/銷(xiāo)售部",
"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ā)中心/開(kāi)發(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ù)說(shuō)明:
參數(shù)名稱(chēng) | 說(shuō)明 |
examID | 考試編號(hào) |
examName | 考試名稱(chēng) |
totalCount | 總記錄數(shù) |
pageSize | 每頁(yè)條數(shù),默認(rèn)1000條 |
currentPageIndex | 當(dāng)前頁(yè)碼 |
account | 考生賬號(hào) |
userName | 考生姓名 |
deptName | 所屬部門(mén) |
fullDeptName | 部門(mén)全路徑 |
beginTime | 考試開(kāi)始時(shí)間 |
endTime | 考試結(jié)束時(shí)間 |
usedTime | 答題時(shí)間 |
passScore | 及格分?jǐn)?shù)線(xiàn) |
paperScore | 卷面總分 |
gradeScore | 考試成績(jī) |
order | 排名 |
isPass | 是否通過(guò)考試,Y為通過(guò),N為不通過(guò) |
integral | 所得積分 |
status | 成績(jī)狀態(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]
請(qǐng)求方式:GET或POST
參數(shù)說(shuō)明:
參數(shù)名稱(chēng) | 說(shuō)明 |
token | 接口調(diào)用憑證,2小時(shí)內(nèi)有效,請(qǐng)注意時(shí)效性 |
action | getUserExam |
account | 考生賬號(hào) |
pageIndex | 分頁(yè)頁(yè)碼,默認(rèn)第1頁(yè) |
pageSize | 每頁(yè)條數(shù),默認(rèn)10條 |
返回值說(shuō)明:
1、執(zhí)行成功
JSON返回值格式
{
"totalCount": 2,
"currentPageIndex": 1,
"items": [
{
"examID": "661502",
"examName": "會(huì)計(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": "會(huì)計(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ù)說(shuō)明:
參數(shù)名稱(chēng) | 說(shuō)明 |
totalCount | 總記錄數(shù) |
currentPageIndex | 當(dāng)前頁(yè)碼 |
examID | 考試編號(hào) |
beginTime | 考試開(kāi)始時(shí)間 |
endTime | 考試結(jié)束時(shí)間 |
examURL | 考試入口鏈接,點(diǎn)擊鏈接進(jìn)入考試 |
examTime | 答題時(shí)間(分鐘) |
allowTimes | 允許參加次數(shù) |
passScore | 通過(guò)考試分?jǐn)?shù)線(xiàn) |
paperScore | 卷面總分 |
2、執(zhí)行失敗,返回值
{"errcode":"40006","errmsg":"AccessToken has expired"}{"errcode":"40501","errmsg":"account參數(shù)不允許為空"}{"errcode":"40502","errmsg":"account:[賬號(hào)]在考試云中不存在"}