#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
}
}