#P1572
GET /api/v2/exams/answers/evaluation
Route Info
| Method |
Endpoint |
Controller |
| GET |
/api/v2/exams/answers/evaluation |
OfficialController@listExamsEvaluation |
شرح عملکرد (Functionality)
این متد وظیفه تحلیل آماری و تجمیع پاسخهای داده شده به یک آزمون خاص را بر عهده دارد. سیستم تمام سوالات فعال آزمون را استخراج کرده و برای هر سوال، پاسخهای کاربران را بر اساس نوع سوال پردازش میکند:
- سوالات تشریحی (Explanatory):
- پاسخهای متنی کاربران عیناً در قالب یک آرایه لیست میشوند تا مدیر بتواند آنها را مطالعه کند.
- سوالات تکگزینهای (Single Choice):
- تعداد دفعات انتخاب هر گزینه محاسبه میشود (هیستوگرام پاسخها).
- میانگین عددی پاسخها (Average) نیز محاسبه میشود (مناسب برای سوالات امتیازدهی یا نظرسنجی عددی).
- سوالات چندگزینهای (Multiple Choice):
- پاسخها که به صورت JSON ذخیره شدهاند (آرایهای از گزینههای انتخاب شده)، باز شده و تعداد انتخاب شدن هر گزینه به صورت جداگانه شمارش میشود.
پارامترهای ورودی (Input Parameters)
| نام پارامتر |
نوع |
الزامی؟ |
توضیحات |
| exam |
Integer |
بله |
شناسه آزمونی که قصد دریافت تحلیل پاسخهای آن را دارید. |
نمونه خروجی (Response)
{
"status": true,
"time": 1732628000,
"data": [
{
"id": 101,
"type": "single_choice",
"subject": "رضایتمندی",
"title": "از کیفیت دوره چقدر رضایت دارید؟ (1 تا 5)",
"options": ["1", "2", "3", "4", "5"],
"description": null,
"mandatory": 1,
"score": 0,
"order": 1,
"relation": false,
"average": 4,
"counter": 50,
"evaluation": {
"5": 30,
"4": 15,
"3": 5
}
},
{
"id": 102,
"type": "explanatory",
"subject": "نظرات",
"title": "پیشنهاد خود را بنویسید",
"average": 0,
"counter": 12,
"evaluation": [
{"response": "بسیار عالی بود"},
{"response": "زمان کلاس کم بود"}
]
}
]
}