DELETE /v2/charter

Charter: Delete (Soft Deactivate) 

 این اندپوینت مسئول حذف نرم (Soft Delete) یا غیرفعال‌سازی یک چارتر است. توجه داشته باشید که این متد رکورد را از دیتابیس پاک نمی‌کند ، بلکه وضعیت (Status) آن را به مقدار 2 تغییر می‌دهد (که معمولاً به معنای غیرفعال یا بایگانی است). 

 

 Request Overview 

 

 

 URL: /v2/charter 

 Method: DELETE 

 Controller: CharterController@deleteCharter 

 Middleware Stack: authWithJwt 

 

 

 Access Control 

 

 

 دسترسی معتبر JWT 

 

 

 Request Parameters 

 

 

 

 

 Field 

 Type 

 Required 

 Description 

 

 

 

 

 id 

 integer 

 yes 

 شناسه چارتری که باید غیرفعال شود 

 

 

 

 

 Logic Details 

 

 

 عملیات مستقیم دیتابیس: این متد از Eloquent Model استفاده نمی‌کند و مستقیماً روی جدول charters کوئری آپدیت می‌زند. 

 تغییر وضعیت: مقدار فیلد status برای رکورد مورد نظر به عدد 2 تغییر می‌یابد. 

 مدیریت خطا: کلیه عملیات داخل بلوک try-catch قرار دارد. در صورت بروز خطا (مثلاً مشکل دیتابیس)، متن خطا و Trace برگردانده می‌شود. 

 

 

 Response (Success) 

 {

 "status": true,

 "time": 1710000000

}

 

 

 Response (Exception Error) 

 {

 "status": false,

 "time": 1710000000,

 "message": "SQLSTATE[...]: Integrity constraint violation...",

 "trace": [...]

}

 

 

 Flowchart 

 

 

 Start (DELETE /v2/charter) 

 ↓ 

 Get Request ID 

 ↓ 

 DB Transaction: Update `charters` SET `status` = 2 

 ↓ 

 

 

 Success 

 ↓ 

 Return { status: true } 

 

 

 Exception 

 ↓ 

 Return { status: false, message... }