#P1667
DELETE /v2/charter
Charter: Delete (Soft Deactivate)
این اندپوینت مسئول حذف نرم (Soft Delete) یا غیرفعالسازی یک چارتر است. توجه داشته باشید که این متد رکورد را از دیتابیس پاک نمیکند، بلکه وضعیت (Status) آن را به مقدار 2 تغییر میدهد (که معمولاً به معنای غیرفعال یا بایگانی است).
Request Overview
URL:
/v2/charterMethod: 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... }