ایران ناتیفیکیشن

وضعیت اشتراک و مصرف ایمیل

اشتراک فعال، سقف‌ها، سهمیهٔ ماهانه، بستهٔ ارسال و موجودی کیف پول برای ایمیل.

GEThttps://api.irnoti.com/v1/email/me
scope: email.read

پیش از ارسال انبوه یا در داشبورد خودتان از این مسیر مصرف و باقی‌ماندهٔ سهمیه را بخوانید. sends.planLeft سهمیهٔ باقی‌ماندهٔ اشتراک، sends.packLeft مجموع بستهٔ ارسال و sends.todaySent ارسال امروز (UTC) است. اگر حساب به‌دلیل سوءاستفادهٔ خودکار مسدود شده باشد، علت در blocked می‌آید.

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

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

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

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

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

curl -X GET 'https://api.irnoti.com/v1/email/me' \
  -H "Authorization: Bearer $IRNOTI_KEY"
پاسخ نمونه200 OK
{
  "sends": {
    "packLeft": 0,
    "planLeft": 18800,
    "planUsed": 1200,
    "planQuota": 20000,
    "todaySent": 35,
    "dailyLimit": 2000
  },
  "blocked": null,
  "subscription": {
    "id": "4",
    "period": "monthly",
    "planName": "حرفه‌ای",
    "autoRenew": true,
    "expiresAt": "2026-11-23T10:00:00.000Z"
  }
}
وضعیت اشتراک و مصرف ایمیل — مستندات API | ایران ناتیفیکیشن