پرش به مستندات
API

خواندن اینکه بر سر نامه‌های فرستاده‌شده چه آمد

اینکه بر سر نامه‌های فرستاده‌شده چه آمد، همان‌طور که صفحهٔ تحلیل‌ها در برنامه نشان می‌دهد.

GET/analytics/sending

فراخوانی واقعی را روی فضای کاری شما اجرا می‌کند.

GET /analytics/sending

اینکه بر سر نامه‌های فرستاده‌شده چه آمد، همان‌طور که صفحهٔ تحلیل‌ها در برنامه نشان می‌دهد.

نمونه

به emails:read نیاز دارد. بازه days است، که مگر خلافش را بگویید 30 و حداکثر 365 است، یا minutes که اولویت دارد، و از آغاز قدیمی‌ترین بخشش شروع می‌شود. grain آن را به روزها، ساعت‌ها یا دقیقه‌ها تقسیم می‌کند.

curl
curl "$OE/analytics/sending?days=7" -H "$AUTH"
پاسخ
{  "object": "sending_analytics",  "since": "2026-09-26T00:00:00.000Z",  "until": "2026-10-02T09:41:00.000Z",  "grain": "day",  "offsetMinutes": 0,  "totals": {    "sends": 412,    "testSends": 3,    "recipients": 498,    "delivered": 486,    "failed": 1,    "bounced": 8,    "complained": 1,    "uncertain": 0,    "pending": 2  },  "days": [    { "day": "2026-10-01", "sent": 74, "delivered": 72, "failed": 0, "bounced": 2, "complained": 0 }  ],  "statuses": [{ "label": "sent", "count": 409 }],  "sources": [    { "label": "api", "count": 288 },    { "label": "composer", "count": 124 }  ],  "senders": [{ "label": "[email protected]", "count": 412 }],  "suppressed": [{ "label": "bounce", "count": 27 }]}

totals می‌شمارد چه چیزی فرستاده شد و به چند گیرنده، و بر سرش چه آمد: تحویل‌شده، ناموفق، برگشتی، شکایت‌شده، نامعلوم و هنوز در انتظار. days همین‌ها را برای هر بخش دارد. statuses، sources و senders ارسال‌ها را به تفکیک وضعیت، به تفکیک جایی که از آن آمده‌اند و به تفکیک نشانی‌ای که با آن بیرون رفته‌اند می‌شمارند، و suppressed نشانی‌های توقیف‌شده را به تفکیک دلیل می‌شمارد.

کلید یا برنامه‌ای که به نشانی‌های خاصی محدود است فقط نامه‌هایی را می‌شمارد که از آن‌ها فرستاده شده‌اند، و address آن را به یک نشانی محدود می‌کند.

مرجع