# GET /api/v2/exams/answers/evaluation

<div id="bkmrk-" style="direction: rtl; font-family: Vazir,Tahoma; text-align: justify; line-height: 1.85;"></div>### Route Info

<div id="bkmrk-method-endpoint-cont" style="direction: rtl; font-family: Vazir,Tahoma; text-align: justify; line-height: 1.85;"><div><table border="1" style="width: 100%; margin: auto; border-collapse: collapse; text-align: center; border: 1px solid #ddd;"><tbody><tr style="background: #f4f4f4; font-weight: bold;"><td style="padding: 10px;">Method</td><td style="padding: 10px;">Endpoint</td><td style="padding: 10px;">Controller</td></tr><tr><td style="direction: ltr; padding: 10px;">GET</td><td style="direction: ltr; padding: 10px;">/api/v2/exams/answers/evaluation</td><td style="direction: ltr; padding: 10px;">OfficialController@listExamsEvaluation</td></tr></tbody></table>

</div></div>### شرح عملکرد (Functionality)

این متد وظیفه تحلیل آماری و تجمیع پاسخ‌های داده شده به یک آزمون خاص را بر عهده دارد. سیستم تمام سوالات فعال آزمون را استخراج کرده و برای هر سوال، پاسخ‌های کاربران را بر اساس نوع سوال پردازش می‌کند:

<div id="bkmrk-%D8%B3%D9%88%D8%A7%D9%84%D8%A7%D8%AA-%D8%AA%D8%B4%D8%B1%DB%8C%D8%AD%DB%8C-%28expla" style="direction: rtl; font-family: Vazir,Tahoma; text-align: justify; line-height: 1.85;">- **سوالات تشریحی (Explanatory):**
    - پاسخ‌های متنی کاربران عیناً در قالب یک آرایه لیست می‌شوند تا مدیر بتواند آن‌ها را مطالعه کند.
- **سوالات تک‌گزینه‌ای (Single Choice):**
    - تعداد دفعات انتخاب هر گزینه محاسبه می‌شود (هیستوگرام پاسخ‌ها).
    - میانگین عددی پاسخ‌ها (Average) نیز محاسبه می‌شود (مناسب برای سوالات امتیازدهی یا نظرسنجی عددی).
- **سوالات چندگزینه‌ای (Multiple Choice):**
    - پاسخ‌ها که به صورت JSON ذخیره شده‌اند (آرایه‌ای از گزینه‌های انتخاب شده)، باز شده و تعداد انتخاب شدن هر گزینه به صورت جداگانه شمارش می‌شود.

</div>### پارامترهای ورودی (Input Parameters)

<div id="bkmrk-%D9%86%D8%A7%D9%85-%D9%BE%D8%A7%D8%B1%D8%A7%D9%85%D8%AA%D8%B1-%D9%86%D9%88%D8%B9-%D8%A7%D9%84%D8%B2%D8%A7" style="direction: rtl; font-family: Vazir,Tahoma; text-align: justify; line-height: 1.85;"><div><table border="1" style="width: 100%; border-collapse: collapse; text-align: right;"><thead><tr style="background: #f4f4f4;"><th style="padding: 8px;">نام پارامتر</th><th style="padding: 8px;">نوع</th><th style="padding: 8px;">الزامی؟</th><th style="padding: 8px;">توضیحات</th></tr></thead><tbody><tr><td style="direction: ltr;">exam</td><td>Integer</td><td>بله</td><td>شناسه آزمونی که قصد دریافت تحلیل پاسخ‌های آن را دارید.</td></tr></tbody></table>

</div></div>### نمونه خروجی (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": "زمان کلاس کم بود"}
            ]
        }
    ]
}
```