گزارش مصرف و کیفیت ارسال

جمع ارسال، تحویل، بازگشت، شکایت و دریافت به‌همراه روند روزانه.

GEThttps://api.irnoti.com/v1/email/report

scope: email.read

گزارش days روز گذشته (پیش‌فرض ۳۰). نرخ‌های rates درصدی از کل ارسال است و نرخ بالای بازگشت یا شکایت ارسال را به‌صورت خودکار محدود می‌کند؛ پس این گزارش را دوره‌ای بررسی کنید. problems ده نامهٔ ناموفق آخر را نشان می‌دهد.

پارامترها

نام	محل	نوع	توضیح
days	query	number	تعداد روز گذشته؛ پیش‌فرض ۳۰.

خطاهای خاص این endpoint

401	unauthorized	کلید API نامعتبر یا منقضی است.
403	insufficient_scope	کلید API دامنهٔ دسترسی لازم را ندارد.

اجرای زنده (محیط تست)

باز کردن در کنسول کامل ←

این endpoint در محیط تست پشتیبانی نمی‌شود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.

→ قبلی

نشانی SMTP و رویدادهای وب‌هوک

بعدی ←

خروجی CSV ارسال‌ها

curl -X GET 'https://api.irnoti.com/v1/email/report?days=7' \
  -H "Authorization: Bearer $IRNOTI_KEY"

پاسخ نمونه200 OK

{
  "days": 7,
  "daily": [
    {
      "day": "2026-10-23",
      "otp": 1,
      "sent": 60,
      "spam": 2,
      "bounced": 1,
      "received": 14,
      "delivered": 59
    }
  ],
  "rates": {
    "bounced": 1.5,
    "delivered": 98,
    "complained": 0
  },
  "totals": {
    "otp": 9,
    "sent": 410,
    "spam": 12,
    "bounced": 6,
    "received": 88,
    "delivered": 402,
    "complained": 0
  }
}