MailLandDocs
دامنه‌ها

افزودن دامنه

افزودن و پیکربندی دامنه ارسال در فضای کاری Mail.Land

پیش از ارسال ایمیل از طریق MailLand، باید حداقل یک دامنه ارسال را اضافه و تأیید کنید. این فرآیند مالکیت شما بر دامنه را اثبات می‌کند و به MailLand اجازه می‌دهد از طرف شما ایمیل ارسال کند.

افزودن دامنه

POST https://api.mail.land/v1/domains
Add a domain
curl -X POST https://api.mail.land/v1/domains \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "yourdomain.com"
  }'

پاسخ

وضعیت: 201 Created

Domain response
{
  "id": "k3v9x2m8q1w7z4",
  "domain": "yourdomain.com",
  "verificationStatus": "pending",
  "spfStatus": "pending",
  "dkimStatus": "pending",
  "dmarcStatus": "pending",
  "isFullyVerified": false,
  "trackingSubdomain": "track",
  "useCustomTracking": false,
  "bounceSubdomain": "bounce",
  "useCustomBounce": true,
  "inboundEnabled": false,
  "inboundSubdomain": null,
  "mxVerified": false,
  "healthStatus": "unknown",
  "createdAt": "2026-02-17T10:00:00Z",
  "updatedAt": "2026-02-17T10:00:00Z"
}
فیلدنوعتوضیحات
idstringشناسه عمومی دامنه
domainstringنام دامنه
verificationStatusenumpending، verified یا failed
spfStatus / dkimStatus / dmarcStatusenumpending، valid یا invalid برای هر رکورد
isFullyVerifiedbooleanمالکیت تأیید شده و SPF و DKIM و DMARC همگی valid، برای ارسال لازم است
trackingSubdomain / bounceSubdomainstringزیردامنه‌های ردیابی/برگشتی، چه دامنه سفارشی روشن باشد چه نباشد
useCustomTracking / useCustomBouncebooleanآیا دامنه ردیابی/برگشتی سفارشی روشن است
inboundEnabledbooleanآیا دریافت ایمیل ورودی برای این دامنه روشن است
inboundSubdomainstring | nullزیردامنهٔ رکورد MX ورودی؛ null یعنی ریشهٔ دامنه
mxVerifiedbooleanآیا رکورد MX ورودی تأیید شده است
healthStatusenumunknown، healthy، warning یا critical
createdAtdatetimeزمان افزودن دامنه

هیچ توکن تأییدی وجود ندارد: افزودن دامنه رکورد را ایجاد کرده و کلید DKIM آن را به‌طور خودکار تولید می‌کند (بدون مرحلهٔ توکن).

پس از افزودن دامنه، باید رکوردهای DNS را پیکربندی کنید و مالکیت آن را تأیید نمایید تا بتوانید ایمیل ارسال کنید. برای مشاهده رکوردهای مورد نیاز، به راه‌اندازی DNS مراجعه کنید.

جریان راه‌اندازی

افزودن دامنه

با نام دامنه خود، درخواست POST /v1/domains را ارسال کنید. MailLand رکورد دامنه را ایجاد کرده و کلید DKIM آن را تولید می‌کند.

دریافت دستورالعمل‌های DNS

درخواست GET /v1/domains/{id}/dns-instructions را ارسال کنید تا رکوردهای دقیق DNS که باید ایجاد کنید را دریافت نمایید. به راه‌اندازی DNS مراجعه کنید.

پیکربندی رکوردهای DNS

رکوردهای SPF، DKIM و DMARC (به‌علاوه CNAMEهای اختیاری برگشتی/ردیابی در صورت فعال بودن) را به ارائه‌دهنده DNS خود اضافه کنید.

تأیید دامنه

درخواست POST /v1/domains/{id}/verify را ارسال کنید تا فرآیند تأیید آغاز شود. MailLand تمام رکوردهای DNS را بررسی کرده و وضعیت دامنه را به‌روز می‌کند. به تأیید مراجعه کنید.

فهرست دامنه‌ها

GET https://api.mail.land/v1/domains
List domains
curl https://api.mail.land/v1/domains \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
List response
{
  "items": [
    {
      "id": "k3v9x2m8q1w7z4",
      "domain": "yourdomain.com",
      "verificationStatus": "verified",
      "spfStatus": "valid",
      "dkimStatus": "valid",
      "dmarcStatus": "valid",
      "isFullyVerified": true,
      "trackingSubdomain": "track",
      "useCustomTracking": false,
      "bounceSubdomain": "bounce",
      "useCustomBounce": false,
      "inboundEnabled": false,
      "inboundSubdomain": null,
      "mxVerified": false,
      "healthStatus": "healthy",
      "createdAt": "2026-02-17T10:00:00Z",
      "updatedAt": "2026-02-17T10:15:00Z"
    }
  ],
  "nextCursor": "eyJ2IjoxLCJzIjoiY3JlYXRlZGF0OmRlc2MiLCJrIjoi...",
  "hasMore": true
}

دریافت یک دامنه

GET https://api.mail.land/v1/domains/{id}

جزئیات کامل دامنه شامل وضعیت تأیید و تمام زیردامنه‌ها را برمی‌گرداند.

Get a domain
curl https://api.mail.land/v1/domains/k3v9x2m8q1w7z4 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

به‌روزرسانی تنظیمات دامنه

سفارشی‌سازی زیردامنه‌های ردیابی و برگشتی، و روشن/خاموش کردن ورودی. سایر فیلدهای تنظیمات: useCustomTracking، useCustomBounce، inboundEnabled، inboundSubdomain. این برچسب‌ها فقط زمانی اعمال می‌شوند که پرچم سفارشی مربوطه روشن و رکورد تأیید شده باشد. روشن کردن useCustomBounce تأیید رکورد برگشتی را پاک می‌کند، بنابراین باید CNAME آن را دوباره تأیید کنید:

PATCH https://api.mail.land/v1/domains/{id}/settings
Update domain settings
curl -X PATCH https://api.mail.land/v1/domains/k3v9x2m8q1w7z4/settings \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "trackingSubdomain": "links",
    "bounceSubdomain": "returns"
  }'

تغییر زیردامنه‌ها مستلزم به‌روزرسانی رکوردهای DNS و تأیید مجدد دامنه است.

حذف یک دامنه

DELETE https://api.mail.land/v1/domains/{id}

در صورت موفقیت، 204 No Content برمی‌گرداند. حذف یک دامنه:

  • تمام کلیدهای DKIM مرتبط با دامنه را باطل می‌کند
  • ارسال تمام ایمیل‌ها از این دامنه را متوقف می‌کند
  • مسیریابی ردیابی و برگشتی را حذف می‌کند
Delete a domain
curl -X DELETE https://api.mail.land/v1/domains/k3v9x2m8q1w7z4 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

حذف دائمی است. هر اعتبارنامه API که به این دامنه محدود شده باشد، دیگر قادر به ارسال ایمیل نخواهد بود. کمپین‌ها یا اتوماسیون‌های فعال که از این دامنه استفاده می‌کنند با خطا مواجه خواهند شد.

پاسخ‌های خطا

وضعیتکدتوضیحات
400VALIDATION_FAILEDفرمت نام دامنه نامعتبر است
400INVALID_REQUESTدامنه قبلاً اضافه شده است (به این فضای کاری یا فضای دیگری)
400DOMAIN_SUBDOMAIN_EMPTYPATCH تنظیمات: یک فیلد زیردامنه خالی ارسال شده است
400DOMAIN_SUBDOMAIN_CONFLICTPATCH تنظیمات: زیردامنهٔ درخواستی از قبل توسط رکورد دیگری از این دامنه استفاده می‌شود
404DOMAIN_NOT_FOUNDشناسه دامنه وجود ندارد
403PLAN_LIMIT_REACHEDحداکثر تعداد دامنه برای پلن شما به پایان رسیده است

MailLand تعداد دامنه‌های ارسال را بر اساس پلن محدود می‌کند و این حد در هر پلن فرق دارد (برخی پلن‌ها نامحدودند). با رسیدن به آن، افزودن دامنه 403 PLAN_LIMIT_REACHED برمی‌گرداند. پلن فعلی خود را در صورتحساب ببینید.

مراحل بعدی

ایمیل‌های زمان‌بندی شده

زمان‌بندی ایمیل‌ها برای ارسال آینده با پشتیبانی از منطقه زمانی

تنظیمات DNS

پیکربندی رکوردهای SPF، DKIM و DMARC برای دامنه ارسال

در این صفحه

افزودن دامنهپاسخجریان راه‌اندازیافزودن دامنهدریافت دستورالعمل‌های DNSپیکربندی رکوردهای DNSتأیید دامنهفهرست دامنه‌هادریافت یک دامنهبه‌روزرسانی تنظیمات دامنهحذف یک دامنهپاسخ‌های خطامراحل بعدی