افزودن نام مستعار

نشانی تازه می‌سازد که نامه‌هایش به صندوق‌های مقصد می‌رسد.

POSThttps://api.irnoti.com/v1/email/domains/{id}/aliases

scope: email.manage

local بخش پیش از @ است. تعداد نام‌های مستعار از سقف بسته می‌آید. هر نام مستعار حداکثر ۲۰ مقصد دارد.

پارامترها

نام	محل	نوع	توضیح
id *	مسیر	string	شناسهٔ دامنه.
local *	بدنه	string	بخش محلی نشانی (حداکثر ۶۴ نویسه).
targets *	بدنه	string[]	نشانی‌های مقصد.

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

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

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

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

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

→ قبلی

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

بعدی ←

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

curl -X POST 'https://api.irnoti.com/v1/email/domains/3/aliases' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "local": "info",
  "targets": [
    "sales@example.ir"
  ]
}'

پاسخ نمونه200 OK

{
  "id": "7",
  "local": "info",
  "address": "info@example.ir",
  "targets": [
    "sales@example.ir",
    "support@example.ir"
  ]
}