Skip to main content
#P1702

GET /v2/mail/sent/get

Mail: Get Sent Details

این اندپوینت برای دریافت جزئیات کامل یک ایمیل ارسال شده استفاده می‌شود.
برخلاف لیست‌ها که اطلاعات خلاصه‌ای ارائه می‌دهند، این متد متن کامل بدنه ایمیل (`content`)، لیست کامل گیرندگان (CC/BCC) و آرایه کامل فایل‌های پیوست را باز می‌گرداند.

Request Overview

URL: /v2/mail/sent/get
Method: GET
Controller: MailController@mailSentGet
Middleware Stack: authWithJwt

Access Control

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

Query Parameters

Field Type Description
mail_id integer (الزامی) شناسه منحصر‌به‌فرد ایمیل در جدول `mail_sent`.

Logic Details

فرآیند واکشی اطلاعات به صورت زیر است:

  1. واکشی ایمیل اصلی: سیستم در جدول mail_sent به دنبال رکوردی می‌گردد که id آن برابر ورودی باشد و status=1 (فعال) باشد.
  2. واکشی پیوست‌ها: همزمان، تمام رکوردهای جدول mail_attachment که mail_id آن‌ها منطبق است و جهت (`direction`) آن‌ها برابر با sent است، استخراج می‌شوند.
  3. فرمت‌دهی داده‌ها:
    • فیلد tag به صورت بولین برگردانده می‌شود (اگر تگ داشته باشد true، در غیر این صورت false).
    • فیلد label اگر موجود باشد مقدار رشته‌ای آن (مثلا "work") و اگر نباشد false برگردانده می‌شود.
    • آرایه attachment حاوی آبجکت‌های کامل فایل‌های پیوست است.

Response Structure

پاسخ موفق

  • Status Code: 200 OK
  • Body:
    {
      "status": true,
      "time": 1670160000,
      "data": {
        "id": 88,
        "direction": "sent",
        "from": "support@mydomain.com",
        "recipients": "client@gmail.com",
        "cc": "manager@mydomain.com",
        "bcc": null,
        "avatar": false,
        "attachment": [
            {
                "id": 10,
                "name": "invoice.pdf",
                "size": "1024kb",
                "storage": "https://s3.bucket..."
            }
        ],
        "subject": "Invoice #12345",
        "content": "Please find attached...",
        "service_id": 1,
        "type": false,
        "tag": true,        // Boolean: has tag or not
        "label": "finance", // String or false
        "created_at": "2023-06-15 09:30:00"
      }
    }

Flowchart

Start (GET /mail/sent/get)
Query `mail_sent`
Where ID = request.id
AND Status = 1
Query `mail_attachment`
Where mail_id = request.id
AND direction = 'sent'
Format Response
Convert Tag to Bool
Handle Label Nulls
Attach Attachments Array
Return JSON Data