انتظار برای کد تأیید جدید

تا رسیدن کد جدید (حداکثر ۶۰ ثانیه) صندوق را بررسی می‌کند؛ مناسب تست خودکار ورود.

GEThttps://api.irnoti.com/v1/email/otp/wait

scope: email.read

هر ۱–۲ ثانیه صندوق همگام و جست‌وجو می‌شود تا کدی پس از since برسد. اگر در مهلت timeout نرسد 409 otp_timeout برمی‌گردد.

پارامترها

نام	محل	نوع	توضیح
mailboxId *	query	string	صندوقی که کد به آن می‌رسد.
since	query	string (ISO 8601)	پیش‌فرض: یک دقیقه پیش.
sender	query	string	فیلتر فرستنده.
timeout	query	number	ثانیه، ۱ تا ۶۰ (پیش‌فرض ۳۰).

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

409	otp_timeout	در مهلت تعیین‌شده کدی نرسید.
401	unauthorized	کلید API نامعتبر یا منقضی است.
403	feature_disabled	قابلیت ایمیل (یا دامنهٔ دسترسی لازم) برای کلید/حساب شما فعال نیست.

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

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

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

→ قبلی

آخرین کدهای تأیید در صندوق

بعدی ←

فهرست نامه‌های دریافتی

curl -X GET 'https://api.irnoti.com/v1/email/otp/wait?sender=github&timeout=30&mailboxId=12' \
  -H "Authorization: Bearer $IRNOTI_KEY"

پاسخ نمونه200 OK

{
  "id": "9001",
  "code": "905566",
  "ageSec": 2,
  "subject": "GitHub launch code",
  "fromAddr": "noreply@github.com",
  "mailboxId": "12",
  "otpSender": "GitHub",
  "receivedAt": "2026-10-21T10:00:00.000Z"
}