#P1448
POST /api/v2/operator/update
Route Info
| Method | Endpoint | Controller | Middleware | Purpose |
| POST | /api/v2/operator/update | UserController@updateOperator | authWithJwt | ویرایش اطلاعات اپراتور و بروزرسانی فایلهای پیوست |
منطق عملکرد
- بررسی فیلد
idبرای شناسه اپراتور هدف. - بروزرسانی تمام ستونهای شخصی و سیستمی (از جمله
passwordهششده). - اگر آرایه
attachmentوجود داشته باشد:- در صورت وجود
idدر آیتم → ویرایش رکورد پیوست. - در غیر این صورت → درج رکورد جدید.
- در صورت وجود
پارامترهای کلیدی
| نام پارامتر | نوع | توضیح |
| id | integer | شناسه اپراتور مورد نظر |
| password | string | رمز عبور جدید (در صورت ارسال، دوباره هش میشود) |
| attachment[] | array | آرایه فایلهای پیوست جدید یا ویرایششده |
نمونه خروجی موفق
{ "status": true, "time": 1732046302 }
دسترسی فقط برای اپراتورهای سطح مدیر؛ از JWT برای شناسایی کاربر استفاده میشود.
- DB
- Carbon
- Hash
میانگین زمان بروزرسانی: 4–5ms برای اپراتور بهعلاوه زمان ثبت ضمیمهها.
در صورت نبود رکورد هدف، خروجی بدون خطای منطقی ولی صرفاً بدون تغییر داده بازمیگردد (پیشنهاد: افزودن بررسی Count).
در صورت ارسال ضمیمه جدید، رکوردهای قبلی بدون delete باقی میمانند مگر توسط ویرایش بعدی حذف شوند.
در حال حاضر فاقد log است؛ پیشنهاد: افزودهشدن UpdateOperator به صف snailJob.
- جداسازی تغییر رمز عبور به endpoint مستقل.
- پاکسازی ضمایم قدیمی هنگام حذف فیزیکی فایل.
این مسیر مکانیزم استاندارد بروزرسانی اپراتورها را فراهم میکند و سازگار با فایل پیوستهای چندگانه است.