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

ویرایش مقصدهای نام مستعار

فهرست مقصدهای یک نام مستعار را جایگزین می‌کند.

PATCHhttps://api.irnoti.com/v1/email/aliases/{id}
scope: email.manage

فهرست جدید به‌طور کامل جای قبلی را می‌گیرد.

پارامترها

ناممحلنوعتوضیح
id *مسیرstringشناسهٔ نام مستعار.
targets *بدنهstring[]نشانی‌های مقصد.

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

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

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

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

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

curl -X PATCH 'https://api.irnoti.com/v1/email/aliases/7' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "targets": [
    "support@example.ir"
  ]
}'
پاسخ نمونه200 OK
{
  "id": "7",
  "local": "info",
  "address": "info@example.ir",
  "targets": [
    "sales@example.ir",
    "support@example.ir"
  ]
}
ویرایش مقصدهای نام مستعار — مستندات API | ایران ناتیفیکیشن