MailLandDocs
Alan Adları

DKIM Anahtar Rotasyonu

Gönderim alan adınız için DKIM imzalama anahtarları

Her alan adının bir DKIM anahtarı vardır (seçici mlnd, RSA-2048), alan adı eklendiğinde otomatik olarak oluşturulur.

Bir DKIM anahtarını döndürmek veya devre dışı bırakmak geçici olarak kullanılamıyor: hem POST /v1/domains/{id}/dkim/{keyId}/rotate hem de DELETE /v1/domains/{id}/dkim/{keyId} 409 CONFLICT döndürür. Mevcut anahtarınız her iki durumda da değişmeden kalır. Bir anahtarın ele geçirildiğinden şüpheleniyorsanız destek ile iletişime geçin: bu, Sahip tarafından yetkilendirilmiş bir olay iş akışıdır, self servis bir uç nokta değildir.

DKIM Anahtarlarını Listeleme

Bir alan adının DKIM anahtar(lar)ını görüntüleyin:

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

Authorization: Bearer <token> veya X-API-Key: <api key> ile kimlik doğrulaması yapın.

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"
  }
]
AlanTürAçıklama
idstringAnahtarın genel kimliği
domainIdstringİlişkili alan adının genel kimliği
domainstringAlan adı
selectorstringDKIM seçici: bugün her zaman mlnd
publicKeystringGenel anahtar (Base64)
keyTypeenumrsa
isActivebooleanBu anahtarın şu anda etkin olup olmadığı
createdAtdatetimeAnahtarın oluşturulduğu zaman
rotatedAtdatetimeAnahtarın son döndürüldüğü zaman (şu anda her zaman null, rotasyon kullanılamıyor)
dnsRecordValuestringTam DNS TXT kayıt değeri
dnsRecordHoststringKaydın eklenmesi gereken DNS ana bilgisayar adı: {selector}._domainkey.{domain}

Bir DKIM Anahtarı Oluşturma

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

Bu yalnızca hiç DKIM anahtarı olmayan bir alan adı için başarılı olur. Her alan adı eklendiğinde otomatik olarak bir anahtar alır, bu yüzden normal bir alan adında bunu çağırmak 409 CONFLICT döndürür. Bir şekilde hiç anahtarı olmayan bir alan adını kurtarmak için vardır.

Başarılı olduğunda (201 Created), yanıt şekli şöyledir:

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."
}

Bir Anahtarı Döndürme veya Devre Dışı Bırakma

Hem POST /v1/domains/{id}/dkim/{keyId}/rotate hem de DELETE /v1/domains/{id}/dkim/{keyId} bugün 409 CONFLICT döndürür (UNG-127 sınırlaması, DNS ile doğrulanmış imzalayıcı değişimi kullanılabilir olana kadar). Bu çağrılardan hiçbiri anahtarınızı, DNS durumunuzu veya Redis/önbelleği değiştirmez: hiçbir şey iptal edilmez ve hiçbir şey gönderimi durdurmaz.

Bir DKIM anahtarının ele geçirildiğinden şüpheleniyorsanız, destek ile iletişime geçin. Bu, Sahip tarafından yetkilendirilmiş bir olay iş akışıdır, bu uç noktalar üzerinden sunulmaz.

Hata Yanıtları

DurumKodAçıklama
409CONFLICTDöndürme/devre dışı bırakma: geçici olarak kullanılamıyor. Oluşturma: alan adının zaten bir anahtarı var.
404RESOURCE_NOT_FOUND"DKIM key not found": anahtar kimliği bu alan adı için mevcut değil
404DOMAIN_NOT_FOUNDAlan adı mevcut değil

Sonraki Adımlar

  • Doğrulama: DNS kayıtlarını ekledikten sonra alan adı sahipliğini doğrulayın
  • DNS Kurulumu: gerekli tüm DNS kayıtlarını gözden geçirin
  • REST API: doğrulanmış alan adınızla e-posta gönderin

Alan Adı Doğrulaması

DNS kaydı doğrulaması ile alan adı sahipliğinizi doğrulayın

Teslim Edilebilirlik Genel Bakış

Tüm alan adlarınızda gönderici itibarını, teslim oranlarını ve DNS durumunu izleyin

Bu sayfada

DKIM Anahtarlarını ListelemeBir DKIM Anahtarı OluşturmaBir Anahtarı Döndürme veya Devre Dışı BırakmaHata YanıtlarıSonraki Adımlar