جزئیات دامنه و رکوردهای DNS

وضعیت دامنه و رکوردهای DNS که باید بسازید (تأیید مالکیت، MX، SPF، DKIM، DMARC).

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

scope: email.read

رکوردها را عیناً در DNS دامنه بگذارید و سپس POST /email/domains/{id}/check را بزنید. تا وقتی status برابر verified نشده، ارسال و دریافت فعال نیست. انتشار DNS گاهی تا چند ساعت طول می‌کشد.

پارامترها

نام	محل	نوع	توضیح
id *	مسیر	string	شناسهٔ دامنه.

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

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

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

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

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

curl -X GET 'https://api.irnoti.com/v1/email/domains/3' \
  -H "Authorization: Bearer $IRNOTI_KEY"

پاسخ نمونه200 OK

{
  "id": "3",
  "mode": "hosted",
  "name": "example.ir",
  "hosted": true,
  "status": "pending",
  "records": [
    {
      "host": "example.ir",
      "type": "TXT",
      "value": "irnoti-verify=abc123",
      "purpose": "verify"
    },
    {
      "host": "example.ir",
      "type": "MX",
      "value": "mail.example.com",
      "purpose": "mx",
      "priority": 10
    },
    {
      "host": "example.ir",
      "type": "TXT",
      "value": "v=spf1 mx ~all",
      "purpose": "spf"
    },
    {
      "host": "irnoti._domainkey.example.ir",
      "type": "TXT",
      "value": "v=DKIM1; k=rsa; p=MIIB…",
      "purpose": "dkim"
    },
    {
      "host": "_dmarc.example.ir",
      "type": "TXT",
      "value": "v=DMARC1; p=none; rua=mailto:dmarc@example.ir; adkim=s; aspf=s",
      "purpose": "dmarc"
    }
  ]
}