Skip to main content
#P1704

DELETE /v2/mail/sent/trash

Mail: Move Sent to Trash

این اندپوینت برای انتقال یک ایمیل ارسال شده به "زباله‌دان" (Trash) استفاده می‌شود.
این عملیات یک حذف نرم (Soft Delete) است؛ رکورد فیزیکی از دیتابیس پاک نمی‌شود، بلکه فیلد type آن به trash تغییر می‌کند تا در لیست‌های عادی نمایش داده نشود.

Request Overview

URL: /v2/mail/sent/trash
Method: DELETE
Controller: MailController@mailSentTrash
Middleware Stack: authWithJwt

Access Control

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

Body/Query Parameters

Field Type Description
mail_id integer (الزامی) شناسه ایمیل مورد نظر در جدول `mail_sent`.

Logic Details

منطق پردازش بسیار ساده است:

  1. به‌روزرسانی وضعیت: کوئری آپدیت روی جدول mail_sent اجرا می‌شود.
  2. شرط: رکوردی که id آن برابر با mail_id ورودی باشد.
  3. تغییر: مقدار ستون type به رشته trash تغییر می‌یابد.

Response Structure

پاسخ موفق

  • Status Code: 200 OK
  • Body: 
    {
  "status": true,
  "time": 1670168000
}

Flowchart

Start (DELETE /mail/sent/trash)
↓
Update `mail_sent`
SET type = 'trash'
WHERE id = request.mail_id
↓
Return Success
Back to top