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

تنظیم Catch-all

نامهٔ ارسال‌شده به هر نشانی ناموجود دامنه را به یک صندوق می‌رساند.

PUThttps://api.irnoti.com/v1/email/domains/{id}/catch-all
scope: email.manage

address باید یکی از صندوق‌ها یا نام‌های مستعار همین دامنه باشد. با null Catch-all خاموش می‌شود و نامهٔ نشانی ناموجود رد می‌شود. Catch-all هرزنامه بیشتری می‌گیرد؛ فیلتر هرزنامه روی آن هم اعمال می‌شود.

پارامترها

ناممحلنوعتوضیح
id *مسیرstringشناسهٔ دامنه.
address *بدنهstring | nullنشانی مقصد یا null.

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

401unauthorizedکلید API نامعتبر یا منقضی است.
403insufficient_scopeکلید API دامنهٔ دسترسی لازم را ندارد.
403feature_disabledقابلیت ایمیل (یا ایمیل سازمانی email.hosted) برای حساب شما فعال نیست.
404not_foundدامنه پیدا نشد یا متعلق به شما نیست.

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

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

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

curl -X PUT 'https://api.irnoti.com/v1/email/domains/3/catch-all' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "address": "info@example.ir"
}'
پاسخ نمونه200 OK
{}
تنظیم Catch-all — مستندات API | ایران ناتیفیکیشن