#P1702
GET /v2/mail/sent/get
Mail: Get Sent Details
این اندپوینت برای دریافت جزئیات کامل یک ایمیل ارسال شده استفاده میشود.
برخلاف لیستها که اطلاعات خلاصهای ارائه میدهند، این متد متن کامل بدنه ایمیل (`content`)، لیست کامل گیرندگان (CC/BCC) و آرایه کامل فایلهای پیوست را باز میگرداند.
Request Overview
URL:
/v2/mail/sent/getMethod: GET
Controller: MailController@mailSentGet
Middleware Stack: authWithJwt
Access Control
- دسترسی معتبر JWT.
Query Parameters
| Field | Type | Description |
|---|---|---|
| mail_id | integer | (الزامی) شناسه منحصربهفرد ایمیل در جدول `mail_sent`. |
Logic Details
فرآیند واکشی اطلاعات به صورت زیر است:
- واکشی ایمیل اصلی: سیستم در جدول
mail_sentبه دنبال رکوردی میگردد کهidآن برابر ورودی باشد وstatus=1(فعال) باشد. - واکشی پیوستها: همزمان، تمام رکوردهای جدول
mail_attachmentکهmail_idآنها منطبق است و جهت (`direction`) آنها برابر باsentاست، استخراج میشوند. - فرمتدهی دادهها:
- فیلد
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
Where ID = request.id
AND Status = 1
↓
Query `mail_attachment`
Where mail_id = request.id
AND direction = 'sent'
Where mail_id = request.id
AND direction = 'sent'
↓
Format Response
Convert Tag to Bool
Handle Label Nulls
Attach Attachments Array
Convert Tag to Bool
Handle Label Nulls
Attach Attachments Array
↓
Return JSON Data