#P1564
GET /api/v2/support/department/questions/list
Route Info
| Method | Endpoint | Controller |
| GET | /api/v2/support/department/questions/list | OfficialController@listQuestionsDepartmentSupport |
شرح عملکرد (Functionality)
این متد لیست سوالات پیشفرض (یا موضوعات تیکت) مربوط به یک دپارتمان خاص را برمیگرداند. کوئری دیتابیس شامل فیلترهای زیر است:
- فیلتر دپارتمان: رکوردهایی که فیلد
departmentآنها برابر با ورودی کاربر باشد. - فیلتر سطح (رابطه): تنها سوالات سطح اول (Root) انتخاب میشوند (شرط
whereNull('relationship')). این یعنی زیرمجموعهها یا پاسخها در این لیست نمیآیند. - فیلتر وضعیت: تنها رکوردهای فعال (
status = 1) انتخاب میشوند.
نکته: خروجی مستقیماً تمام ستونهای جدول support_questions را بدون تغییر ساختار برمیگرداند.
پارامترهای ورودی (Input Parameters)
| نام پارامتر | نوع | الزامی؟ | توضیحات |
|---|---|---|---|
| department | Integer | بله | شناسه دپارتمان مورد نظر برای دریافت لیست سوالات آن. |
نمونه خروجی (Response)
{
"status": true,
"time": 1732619000,
"data": [
{
"id": 101,
"department": 5,
"title": "مشکل در صدور بلیط",
"relationship": null, // چون whereNull اعمال شده
"status": 1,
"created_at": "2024-01-01 12:00:00",
"updated_at": "2024-01-01 12:00:00"
},
{
"id": 102,
"department": 5,
"title": "درخواست استرداد وجه",
"relationship": null,
"status": 1,
"created_at": "2024-01-02 10:30:00",
"updated_at": "2024-01-02 10:30:00"
}
]
}