MailLandDocs
Domains

DKIM-Schlüsselrotation

DKIM-Signaturschlüssel für Ihre Sendedomain

Jede Domain hat einen DKIM-Schlüssel (Selektor mlnd, RSA-2048), der automatisch beim Hinzufügen der Domain erstellt wird.

Das Rotieren oder Deaktivieren eines DKIM-Schlüssels ist vorübergehend nicht verfügbar: Sowohl POST /v1/domains/{id}/dkim/{keyId}/rotate als auch DELETE /v1/domains/{id}/dkim/{keyId} geben 409 CONFLICT zurück. Ihr bestehender Schlüssel bleibt in beiden Fällen unverändert. Wenn Sie einen kompromittierten Schlüssel vermuten, kontaktieren Sie den Support: dies ist ein vom Owner autorisierter Incident-Workflow, kein Self-Service-Endpunkt.

DKIM-Schlüssel auflisten

Den/die DKIM-Schlüssel einer Domain anzeigen:

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

Authentifizieren Sie sich mit Authorization: Bearer <token> oder 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"
  }
]
FeldTypBeschreibung
idstringÖffentliche Schlüssel-ID
domainIdstringÖffentliche ID der zugehörigen Domain
domainstringDomainname
selectorstringDKIM-Selektor: heute immer mlnd
publicKeystringÖffentlicher Schlüssel (Base64)
keyTypeenumrsa
isActivebooleanOb dieser Schlüssel aktuell aktiv ist
createdAtdatetimeWann der Schlüssel erstellt wurde
rotatedAtdatetimeWann der Schlüssel zuletzt rotiert wurde (derzeit immer null, Rotation nicht verfügbar)
dnsRecordValuestringVollständiger DNS-TXT-Eintragswert
dnsRecordHoststringDNS-Hostname für den Eintrag: {selector}._domainkey.{domain}

Einen DKIM-Schlüssel generieren

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

Dies gelingt nur für eine Domain, die keinen DKIM-Schlüssel hat. Jede Domain erhält beim Hinzufügen automatisch einen, daher gibt ein Aufruf bei einer normalen Domain 409 CONFLICT zurück. Er dient dazu, eine Domain wiederherzustellen, die aus irgendeinem Grund keinen Schlüssel hat.

Bei Erfolg (201 Created) sieht die Antwort so aus:

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

Einen Schlüssel rotieren oder deaktivieren

Sowohl POST /v1/domains/{id}/dkim/{keyId}/rotate als auch DELETE /v1/domains/{id}/dkim/{keyId} geben heute 409 CONFLICT zurück (UNG-127-Eindämmung, bis eine DNS-verifizierte Signer-Umschaltung verfügbar ist). Keiner der Aufrufe ändert Ihren Schlüssel, Ihren DNS-Status oder Redis/Caches: nichts wird widerrufen und nichts stoppt den Versand.

Wenn Sie vermuten, dass ein DKIM-Schlüssel kompromittiert wurde, kontaktieren Sie den Support. Dies ist ein vom Owner autorisierter Incident-Workflow: er ist über diese Endpunkte nicht verfügbar.

Fehlerantworten

StatusCodeBeschreibung
409CONFLICTRotieren/Deaktivieren: vorübergehend nicht verfügbar. Generieren: die Domain hat bereits einen Schlüssel.
404RESOURCE_NOT_FOUND"DKIM key not found": die Schlüssel-ID existiert nicht für diese Domain
404DOMAIN_NOT_FOUNDDomain existiert nicht

Nächste Schritte

  • Verifizierung: Domain-Eigentum nach dem Hinzufügen von DNS-Einträgen verifizieren
  • DNS-Einrichtung: alle erforderlichen DNS-Einträge überprüfen
  • REST API: E-Mails mit Ihrer verifizierten Domain senden

Domain-Verifizierung

Domain-Besitz durch DNS-Eintragsvalidierung verifizieren

Zustellbarkeitsübersicht

Überwachen Sie die Absenderreputation, Zustellraten und DNS-Gesundheit über alle Ihre Domains hinweg

Auf dieser Seite

DKIM-Schlüssel auflistenEinen DKIM-Schlüssel generierenEinen Schlüssel rotieren oder deaktivierenFehlerantwortenNächste Schritte