همگام‌سازی فوری صندوق

نامه‌های جدید را همین الان از سرور می‌گیرد، به‌جای انتظار برای همگام‌سازی دوره‌ای.

POSThttps://api.irnoti.com/v1/email/sync

scope: email.read

بدون mailboxId همهٔ صندوق‌ها همگام می‌شوند. اگر همین صندوق کمتر از ۳ ثانیه پیش همگام شده باشد درخواست نادیده گرفته می‌شود. بعد از همگام‌سازی از GET /email/otp/wait یا GET /email/messages بخوانید. سقف: ۶۰ درخواست در دقیقه.

پارامترها

نام	محل	نوع	توضیح
mailboxId	بدنه	string	فقط یک صندوق.

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

401	unauthorized	کلید API نامعتبر یا منقضی است.
403	insufficient_scope	کلید API دامنهٔ دسترسی لازم را ندارد.
404	not_found	صندوق پیدا نشد یا متعلق به شما نیست.
429	rate_limited	سقف تعداد درخواست رد شده است؛ بعد از چند ثانیه دوباره تلاش کنید.

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

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

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

→ قبلی

خالی‌کردن سطل زباله یا هرزنامه

بعدی ←

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

curl -X POST 'https://api.irnoti.com/v1/email/sync' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "mailboxId": "12"
}'

پاسخ نمونه200 OK

{}