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

فهرست صندوق‌ها

صندوق‌های سازمانی و حساب‌های شخصی متصل‌شدهٔ شما، و صندوق‌هایی که به شما تخصیص داده شده است.

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

kind برابر hosted (صندوق روی دامنهٔ شما) یا external (Gmail، Yahoo، Outlook و سرور شخصی) است. lastError آخرین خطای همگام‌سازی را نشان می‌دهد؛ مثلاً رمز برنامهٔ منقضی‌شده.

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

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

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

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

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

curl -X GET 'https://api.irnoti.com/v1/email/mailboxes' \
  -H "Authorization: Bearer $IRNOTI_KEY"
پاسخ نمونه200 OK
[
  {
    "id": "12",
    "kind": "hosted",
    "status": "active",
    "address": "sales@example.ir",
    "quotaMb": 2048,
    "lastError": null,
    "usedBytes": 5242880,
    "lastSyncAt": "2026-10-24T08:30:00.000Z",
    "displayName": "فروش"
  }
]
فهرست صندوق‌ها — مستندات API | ایران ناتیفیکیشن