獲取考生成績¶
注: 所有接口只針對旗艦會員提供,非旗艦會員無法調用,所有開放平臺接口默認共享10QPS
獲取某一考生參與考試的記錄¶
通過該接口,可以獲取考生在某一份試卷下的考生成績。
接口如下所示:
GET http://www.bigeyebrow.com/index.php?option=com_exams&task=api.queryResults&format=raw
參數:
code=權限碼&eid=試卷ID&loginValues=考生登錄字段值&start=0&limit=30
參數說明:
- code 每個賬戶唯一對應的驗證碼,string類型,該值可聯系優考試獲取
- eid 表示試卷ID
- loginValues 表示的是考生的登錄值,可選參數,比如說系統設置了使用手機登錄,那么這里就是考生的手機號碼
- start 用于數據量很大時的分頁顯示,表示分頁的數據偏移, 默認為0, 可選參數
- limit 用于數據量很大時的分布顯示,設置每頁的數據顯示數量,默認為30, 可選參數
該接口返回考生在這個試卷里的所有考試記錄信息
[
{
"viewResult":"https://ks.youkaoshi.cn/viewresult/token",//查看詳細考試詳情的鏈接,有30分鐘時間限制,超過30分鐘后得重新獲取鏈接
"score": 30,//考試得分,float類型
"startTime": 1539075728,//考生開始作答的時間戳,int類型,單位s(秒)
"endTime": 1539075828,//考生交卷的時間戳,int類型,單位s(秒)
"status": 1,//status 表示答卷狀態,1表示正常交卷, 0正在考試中,2表示超時自動交卷,3表示被管理員強制交卷,4表示系統執行交卷
},
{
"viewResult":"https://ks.youkaoshi.cn/viewresult/token",//查看詳細考試詳情的鏈接,有30分鐘時間限制,超過30分鐘后得重新獲取鏈接
"score": 32,//考試得分,float類型
"startTime": 1539075628,//考生開始作答的時間戳,int類型,單位s(秒)
"endTime": 1539075828,//考生交卷的時間戳,int類型,單位s(秒)
"status": 1,//status 表示答卷狀態,1表示正常交卷, 0正在考試中,2表示超時自動交卷,3表示被管理員強制交卷,4表示系統執行交卷
},
]
獲取參與考試的所有考試記錄信息¶
如果沒有指定 loginValues 的話, 則返回的是所有參與該試卷考試的考試記錄數據
[
{
"viewResult":"https://ks.youkaoshi.cn/viewresult/token",//查看詳細考試詳情的鏈接,有30分鐘時間限制,超過30分鐘后得重新獲取鏈接
"score": 30,//考試得分,float類型
"startTime": 1539075728,//考生開始作答的時間戳,int類型,單位s(秒)
"endTime": 1539075828,//考生交卷的時間戳,int類型,單位s(秒)
"loginValues": 19382,
"name": "王二"
},
{
"viewResult":"https://ks.youkaoshi.cn/viewresult/token",//查看詳細考試詳情的鏈接,有30分鐘時間限制,超過30分鐘后得重新獲取鏈接
"score": 32,//考試得分,float類型
"startTime": 1539075628,//考生開始作答的時間戳,int類型,單位s(秒)
"endTime": 1539075828,//考生交卷的時間戳,int類型,單位s(秒)
"loginValues": 19310, //考生登錄字段值
"name": "張三" //考生的姓名
},
]
獲取試卷列表¶
試卷很多的情況下需要通過接口來動態獲取試卷列表。接口如下:
GET http://www.bigeyebrow.com/index.php?option=com_exams&task=api.getExams&format=raw
參數
code=權限碼&start=0&limit=30
參數說明:
- code 每個賬戶唯一對應的驗證碼,string類型,該值可聯系優考試獲取
- start 用于數據量很大時的分頁顯示,表示分頁的數據偏移, 默認為0, 可選參數
- limit 用于數據量很大時的分布顯示,設置每頁的數據顯示數量,默認為30, 可選參數
返回數據:
[
{
"eid": 23812,//試卷id,int類型
"title": "測試試卷", // 試卷標題,string類型
"img": "https://fs.youkaoshi.cn/xxxxx.jpg",// 試卷封面圖片鏈接,string類型
"url": "https://ks.youkaoshi.cn/23812", //試卷考試鏈接,string類型
"createTime": 1539075828,//試卷創建時間的unix時間戳,int類型,單位s(秒)
"available": 1, //試卷是否可用,int類型,1表示可用,0表示不可用
"times": 3918, //試卷的考試次數
"category": "???quot; //試卷的分類名稱
},
...
]