افزودن دامنه

دامنه را ثبت و رکوردهای DNS لازم را برمی‌گرداند.

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

scope: email.manage

mode: hosted (ایمیل سازمانی؛ دریافت و ارسال) یا sending (فقط ارسال). رکوردها را در DNS دامنه ثبت و سپس POST /email/domains/{id}/check را صدا بزنید.

پارامترها

نام	محل	نوع	توضیح
name *	بدنه	string	نام دامنه.
mode	بدنه	string	`hosted` (پیش‌فرض) یا `sending`.

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

402	plan_limit	سقف دامنهٔ بسته پر است.
409	domain_taken	دامنه قبلاً ثبت شده است.
401	unauthorized	کلید API نامعتبر یا منقضی است.
403	feature_disabled	قابلیت ایمیل (یا دامنهٔ دسترسی لازم) برای کلید/حساب شما فعال نیست.

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

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

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

curl -X POST 'https://api.irnoti.com/v1/email/domains' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "mode": "hosted",
  "name": "example.ir"
}'

پاسخ نمونه200 OK

{
  "id": "3",
  "name": "example.ir",
  "status": "pending",
  "records": [
    {
      "host": "example.ir",
      "type": "TXT",
      "value": "irnoti-verify=…",
      "purpose": "verify"
    },
    {
      "host": "example.ir",
      "type": "MX",
      "value": "mail.irnoti.com",
      "purpose": "mx",
      "priority": 10
    }
  ]
}