Skip to main content
#P1563

GET /api/v2/support/department/members

Route Info

Method Endpoint Controller
GET /api/v2/support/department/members OfficialController@listDepartmentMembersSupport

شرح عملکرد (Functionality)

این متد لیست اعضای (پاسخ‌دهندگان) یک دپارتمان پشتیبانی خاص را برمی‌گرداند. فرآیند پردازش به شرح زیر است:

  • بررسی اعتبار: ابتدا وجود دپارتمان بر اساس شناسه ورودی بررسی می‌شود. اگر دپارتمان یافت نشود یا لیست اعضای آن (`members`) خالی باشد، یک خطای JSON با کد 1000 بازگردانده می‌شود.
  • استخراج اعضا: فیلد `members` در دیتابیس به صورت یک آرایه JSON ذخیره شده است. سیستم این آرایه را دیکد کرده و روی شناسه‌های پرسنلی (IDs) حلقه می‌زند.
  • هیدراته کردن اطلاعات کاربر: برای هر شناسه عددی، متد StaticController::getOperators فراخوانی می‌شود. از آنجا که کد از ایندکس [0] استفاده می‌کند، هر آیتم در آرایه خروجی یک آبجکت کامل کاربر است (نه آرایه تو در تو).

پارامترهای ورودی (Input Parameters)

نام پارامتر نوع الزامی؟ توضیحات
department Integer بله شناسه دپارتمان مورد نظر که لیست اعضای آن درخواست شده است.

نمونه خروجی (Response)

خروجی شامل آرایه‌ای از آبجکت‌های کاربر در فیلد items است.

{
    "items": [
        {
            "id": 15,
            "text": "1005 - نام و نام خانوادگی",
            "query": {
                "id": 15,
                "personnel_id": 1005,
                "first_name": "نام",
                "last_name": "نام خانوادگی",
                "branch": "[1]",
                "status": 1,
                // سایر فیلدهای جدول کاربران
                ...
            }
        },
        {
            "id": 22,
            "text": "1008 - کاربر دوم",
            "query": { ... }
        }
    ],
    "meta": {
        "timestamp": 1732618000
    }
}

نمونه خطا (در صورت نبود دپارتمان یا عضو):

{
    "error": {
        "code": 1000,
        "message": "در این دپارتمان عضوی وجود ندارد و یا اینکه دپارتمان اشتباه ارسال شده است."
    },
    "meta": {
        "timestamp": 1732618005
    }
}