Skip to main content
#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": "زمان کلاس کم بود"}
            ]
        }
    ]
}