MailLandDocs
Domaines

Rotation des clés DKIM

Clés de signature DKIM pour votre domaine d'envoi

Chaque domaine a une clé DKIM (sélecteur mlnd, RSA-2048), créée automatiquement lors de l'ajout du domaine.

La rotation ou la désactivation d'une clé DKIM est temporairement indisponible : POST /v1/domains/{id}/dkim/{keyId}/rotate et DELETE /v1/domains/{id}/dkim/{keyId} renvoient tous deux 409 CONFLICT. Votre clé existante reste inchangée dans les deux cas. Si vous suspectez qu'une clé est compromise, contactez le support : il s'agit d'un flux d'incident autorisé par le propriétaire, pas d'un point de terminaison en libre-service.

Lister les clés DKIM

Consultez la ou les clés DKIM d'un domaine :

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

Authentifiez-vous avec Authorization: Bearer <token> ou 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"
  }
]
ChampTypeDescription
idstringID public de la clé
domainIdstringID public du domaine associé
domainstringNom de domaine
selectorstringSélecteur DKIM : toujours mlnd aujourd'hui
publicKeystringClé publique (Base64)
keyTypeenumrsa
isActivebooleanSi cette clé est actuellement active
createdAtdatetimeDate de création de la clé
rotatedAtdatetimeDate de la dernière rotation de la clé (toujours null actuellement, la rotation est indisponible)
dnsRecordValuestringValeur complète de l'enregistrement TXT DNS
dnsRecordHoststringNom d'hôte DNS où ajouter l'enregistrement : {selector}._domainkey.{domain}

Générer une clé DKIM

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

Cela ne réussit que pour un domaine qui n'a aucune clé DKIM. Chaque domaine en reçoit une automatiquement lors de son ajout, donc appeler ceci sur un domaine normal renvoie 409 CONFLICT. Cela existe pour récupérer un domaine qui n'en a aucune pour une raison quelconque.

En cas de succès (201 Created), la forme de la réponse est :

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

Faire une rotation ou désactiver une clé

POST /v1/domains/{id}/dkim/{keyId}/rotate et DELETE /v1/domains/{id}/dkim/{keyId} renvoient tous deux 409 CONFLICT aujourd'hui (confinement UNG-127, en attendant un changement de signataire vérifié par DNS). Aucun des deux appels ne modifie votre clé, votre état DNS, ou Redis/le cache : rien n'est révoqué et rien n'arrête l'envoi.

Si vous suspectez qu'une clé DKIM a été compromise, contactez le support. Il s'agit d'un flux d'incident autorisé par le propriétaire : il n'est pas exposé via ces points de terminaison.

Réponses d'erreur

StatutCodeDescription
409CONFLICTRotation/désactivation : temporairement indisponible. Génération : le domaine a déjà une clé.
404RESOURCE_NOT_FOUND"DKIM key not found" : l'ID de la clé n'existe pas pour ce domaine
404DOMAIN_NOT_FOUNDLe domaine n'existe pas

Étapes suivantes

  • Vérification : vérifier la propriété du domaine après avoir ajouté les enregistrements DNS
  • Configuration DNS : revoir tous les enregistrements DNS requis
  • REST API : envoyer des e-mails avec votre domaine vérifié

Vérification de domaine

Vérifiez la propriété de votre domaine via la validation des enregistrements DNS

Vue d'ensemble de la délivrabilité

Surveillez la réputation de l'expéditeur, les taux de livraison et l'état DNS de tous vos domaines

Sur cette page

Lister les clés DKIMGénérer une clé DKIMFaire une rotation ou désactiver une cléRéponses d'erreurÉtapes suivantes