#P1707
DELETE /v2/mail/inbox/trash
Mail: Move Inbox to Trash
این اندپوینت برای انتقال یک ایمیل ورودی (Inbox) به "زبالهدان" (Trash) استفاده میشود.
مشابه اندپوینت بخش ارسالیها، این عملیات نیز یک حذف نرم (Soft Delete) است و رکورد فیزیکی از دیتابیس پاک نمیشود؛ تنها فیلد type آن به trash تغییر میکند.
Request Overview
URL:
/v2/mail/inbox/trashMethod: DELETE
Controller: MailController@mailInboxTrash
Middleware Stack: authWithJwt
Access Control
- دسترسی معتبر JWT.
Body/Query Parameters
| Field | Type | Description |
|---|---|---|
| mail_id | integer | (الزامی) شناسه ایمیل مورد نظر در جدول `mail_inbox`. |
Logic Details
مراحل پردازش:
- بهروزرسانی دیتابیس: کوئری آپدیت روی جدول
mail_inboxاجرا میشود. - شرط: رکوردی که
idآن برابر باmail_idورودی باشد. - تغییر وضعیت: مقدار ستون
typeبه رشتهtrashتغییر مییابد تا از صندوق ورودی اصلی مخفی شود.
Response Structure
پاسخ موفق
- Status Code:
200 OK - Body:
{ "status": true, "time": 1670175000 }
Flowchart
Start (DELETE /mail/inbox/trash)
↓
Update `mail_inbox`
SET type = 'trash'
WHERE id = request.mail_id
SET type = 'trash'
WHERE id = request.mail_id
↓
Return Success