چرخش کلید DKIM

هر دامنه یک کلید DKIM دارد (سلکتور mlnd، RSA-2048) که هنگام افزودن دامنه به‌طور خودکار ایجاد می‌شود.

چرخش یا غیرفعال‌سازی کلید DKIM موقتاً در دسترس نیست: هر دو POST /v1/domains/{id}/dkim/{keyId}/rotate و DELETE /v1/domains/{id}/dkim/{keyId} مقدار 409 CONFLICT برمی‌گردانند. کلید فعلی شما در هر دو حالت بدون تغییر باقی می‌ماند. اگر گمان می‌کنید کلیدی به خطر افتاده، با پشتیبانی تماس بگیرید: این یک فرایند رسیدگی به حادثه با تأیید مالک است، نه یک نقطهٔ پایانی خودسرویس.

فهرست کلیدهای DKIM

کلید(های) DKIM یک دامنه را مشاهده کنید:

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

با استفاده از Authorization: Bearer <token> یا X-API-Key: <api key> احراز هویت کنید.

List DKIM keys

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

DKIM keys response

[
  {
    "id": "d7f2k9m1x3w8z",
    "domainId": "k3v9x2m8q1w7z4",
    "domain": "yourdomain.com",
    "selector": "mlnd",
    "publicKey": "MIIBIjANBgkqhkiG9w0BAQE...",
    "keyType": "rsa",
    "isActive": true,
    "createdAt": "2026-02-17T10:00:00Z",
    "rotatedAt": null,
    "dnsRecordValue": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQE...",
    "dnsRecordHost": "mlnd._domainkey.yourdomain.com"
  }
]

فیلد	نوع	توضیح
`id`	string	شناسه عمومی کلید
`domainId`	string	شناسه عمومی دامنه مرتبط
`domain`	string	نام دامنه
`selector`	string	سلکتور DKIM: امروز همیشه `mlnd`
`publicKey`	string	کلید عمومی (Base64)
`keyType`	enum	`rsa`
`isActive`	boolean	آیا این کلید در حال حاضر فعال است
`createdAt`	datetime	زمان ایجاد کلید
`rotatedAt`	datetime	زمان آخرین چرخش کلید (در حال حاضر همیشه `null`، چرخش در دسترس نیست)
`dnsRecordValue`	string	مقدار کامل رکورد TXT دی‌ان‌اس
`dnsRecordHost`	string	نام میزبان DNS که رکورد باید در آن افزوده شود: `{selector}._domainkey.{domain}`

ایجاد یک کلید DKIM

POST https://api.mail.land/v1/domains/{id}/dkim/generate

این فقط برای دامنه‌ای که هیچ کلید DKIM ندارد موفق می‌شود. هر دامنه هنگام افزوده شدن به‌طور خودکار یک کلید دریافت می‌کند، بنابراین فراخوانی این روی یک دامنه عادی مقدار 409 CONFLICT برمی‌گرداند. این برای بازیابی دامنه‌ای است که به هر دلیلی هیچ کلیدی ندارد.

در صورت موفقیت (201 Created)، شکل پاسخ چنین است:

Generate response (only when the domain has no key)

{
  "key": {
    "id": "d7f2k9m1x3w8z",
    "domainId": "k3v9x2m8q1w7z4",
    "domain": "yourdomain.com",
    "selector": "mlnd",
    "publicKey": "MIIBIjANBgkqhkiG9w0BAQE...",
    "keyType": "rsa",
    "isActive": true,
    "createdAt": "2026-02-17T10:00:00Z",
    "rotatedAt": null,
    "dnsRecordValue": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQE...",
    "dnsRecordHost": "mlnd._domainkey.yourdomain.com"
  },
  "dnsInstructions": {
    "recordType": "TXT",
    "hostName": "mlnd._domainkey.yourdomain.com",
    "value": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQE...",
    "instructions": "Add a TXT record with hostname 'mlnd._domainkey' and the value shown above. DNS propagation may take up to 48 hours."
  },
  "message": "DKIM key generated successfully. Please add the DNS record and verify your domain."
}

چرخش یا غیرفعال‌سازی یک کلید

هر دو POST /v1/domains/{id}/dkim/{keyId}/rotate و DELETE /v1/domains/{id}/dkim/{keyId} امروز 409 CONFLICT برمی‌گردانند (مهار UNG-127، تا زمانی که جابه‌جایی امضاکنندهٔ تأییدشده با DNS در دسترس باشد). هیچ‌کدام از این فراخوانی‌ها کلید شما، وضعیت DNS یا Redis/کش را تغییر نمی‌دهند: چیزی لغو نمی‌شود و چیزی ارسال را متوقف نمی‌کند.

اگر گمان می‌کنید کلید DKIM به خطر افتاده، با پشتیبانی تماس بگیرید. این یک فرایند رسیدگی به حادثه با تأیید مالک است: از طریق این نقاط پایانی در دسترس نیست.

پاسخ‌های خطا

وضعیت	کد	توضیح
`409`	`CONFLICT`	چرخش/غیرفعال‌سازی: موقتاً در دسترس نیست. ایجاد: دامنه از قبل یک کلید دارد.
`404`	`RESOURCE_NOT_FOUND`	"DKIM key not found": شناسه کلید برای این دامنه وجود ندارد
`404`	`DOMAIN_NOT_FOUND`	دامنه وجود ندارد

مراحل بعدی

تأیید: پس از افزودن رکوردهای DNS، مالکیت دامنه را تأیید کنید
راه‌اندازی DNS: همه رکوردهای DNS لازم را بررسی کنید
REST API: با دامنه تأییدشده خود ایمیل ارسال کنید

چرخش کلید DKIM

فهرست کلیدهای DKIMکپی پیوند بخش

ایجاد یک کلید DKIMکپی پیوند بخش

چرخش یا غیرفعال‌سازی یک کلیدکپی پیوند بخش

پاسخ‌های خطاکپی پیوند بخش

مراحل بعدیکپی پیوند بخش

در این صفحه

فهرست کلیدهای DKIM

ایجاد یک کلید DKIM

چرخش یا غیرفعال‌سازی یک کلید

پاسخ‌های خطا

مراحل بعدی