#P1431
GET /api/v2/cartable/categories
Route Info
| Method | Endpoint | Controller | Middleware | Purpose |
| GET | /api/v2/cartable/categories | UserController@cartableCategories | authWithJwt | دریافت لیست دستهبندیهای کارتابل سیستم |
منطق عملکرد
- تعریف آرایه ثابت شامل ۶ دسته:
- درخواستهای بررسی نشده (`unchecked_requests`)
- درخواستهای رد شده (`rejected_requests`)
- درخواستهای تایید شده (`approved_requests`)
- نامههای بررسی نشده (`unchecked_letters`)
- نامههای رد شده (`rejected_letters`)
- نامههای تایید شده (`approved_letters`)
- بازگرداندن آرایه در قالب JSON با کلید `data`.
- مدیریت خطا با Try/Catch و ارسال پاسخ 400 در صورت Exception.
پارامترهای ورودی
بدون پارامتر ورودی؛ فقط نیاز به JWT معتبر.
GET /api/v2/cartable/categories Authorization: Bearer <JWT>
نمونه خروجی موفق
{
"status": true,
"time": 1732035500,
"data": [
{"id":1,"slug":"unchecked_requests","title":"درخواست های بررسی نشده","icon":"heroicons-outline:puzzle"},
{"id":2,"slug":"rejected_requests","title":"درخواست های رد شده","icon":"heroicons-outline:hand"},
{"id":3,"slug":"approved_requests","title":"درخواست های تائید شده","icon":"heroicons-outline:inbox"},
{"id":4,"slug":"unchecked_letters","title":"نامه های بررسی نشده","icon":"heroicons-outline:annotation"},
{"id":5,"slug":"rejected_letters","title":"نامه های رد شده","icon":"heroicons-outline:thumb-down"},
{"id":6,"slug":"approved_letters","title":"نامه های تائید شده","icon":"heroicons-outline:mail-open"}
]
}
امنیت
- JWT معتبر الزامی است.
Dependencies
- Exception
- Laravel Response Facade
کارایی
پاسخ کاملاً ایستا؛ زمان اجرا کمتر از 1 ms.
مدیریت خطا
Exception بهصورت کلی با status=false و کد خطا 400 برگردانده میشود.
اثرات جانبی
ندارد.
ردپای حسابرسی
ندارد.
پیشنهاد بهبود
- جداکردن دادهها به فایل config برای چندزبانهسازی آسان.
- افزودن سطح دسترسی بر اساس نقش (role) در آینده.
جمعبندی
روت دستهبندیها برای رابطهای کارتابل کاربرد دارد و کاملاً ایستا است؛ طراحی ساده و سریع.