#P1570
GET /api/v2/exams/list
Route Info
| Method |
Endpoint |
Controller |
| GET |
/api/v2/exams/list |
OfficialController@listExams |
شرح عملکرد (Functionality)
این متد لیست تمامی آزمونهای فعال مرتبط با شعبه جاری را استخراج کرده و آماری از وضعیت هر آزمون ارائه میدهد:
- فیلتر آزمونها: تنها آزمونهایی که فیلد
status آنها برابر با 1 است و متعلق به branch درخواستکننده هستند، انتخاب میشوند.
- محاسبه آمار (Statistics): برای هر آزمون، دو مقدار محاسبه میشود:
requests: تعداد کل سوالات تعریف شده برای آن آزمون (از جدول exam_questions).answers: تعداد کل پاسخنامههای ثبت شده توسط کاربران (از جدول exam_response).
پارامترهای ورودی (Input Parameters)
| نام پارامتر |
نوع |
الزامی؟ |
توضیحات |
| branch |
Integer |
بله |
شناسه شعبه (این مقدار معمولاً از توکن احراز هویت استخراج میشود). |
نمونه خروجی (Response)
{
"status": true,
"time": 1732626000,
"data": [
{
"id": 10,
"type": "general",
"title": "آزمون جامع نیمسال اول",
"requests": 25,
"answers": 140
},
{
"id": 12,
"type": "specialized",
"title": "آزمون تخصصی فنی",
"requests": 10,
"answers": 45
}
]
}
