Vérification de domaine

Après avoir configuré les enregistrements DNS, déclenchez la vérification pour prouver la propriété du domaine et débloquer l'envoi d'e-mails. MailLand vérifie les enregistrements SPF, DKIM, DMARC et de chemin de retour.

Vérifier un domaineCopier le lien de la section

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

Authentifiez-vous avec Authorization: Bearer <token> ou X-API-Key: <api key>.

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

RéponseCopier le lien de la section

{
  "domainId": "k3v9x2m8q1w7z4",
  "domain": "yourdomain.com",
  "isVerified": true,
  "spfStatus": "valid",
  "dkimStatus": "valid",
  "dmarcStatus": "valid",
  "verifiedAt": "2026-02-17T10:15:00Z",
  "message": "Domain successfully verified with all DNS records valid",
  "dnsRecords": {
    "spfRecord": "v=spf1 include:spf.mlnd.net ~all",
    "dkimSelector": "mlnd",
    "dkimRecord": "v=DKIM1; k=rsa; p=MIIBIjANBgkq...",
    "dmarcRecord": "v=DMARC1; p=none; rua=mailto:[email protected]"
  },
  "trackingVerified": false,
  "bounceVerified": true,
  "bounceVerifiedAt": "2026-02-17T10:15:00Z",
  "mxVerified": false,
  "lastDnsCheckAt": "2026-02-17T10:15:00Z"
}

Statuts des enregistrementsCopier le lien de la section

Chaque vérification d'enregistrement DNS retourne l'un de ces statuts :

Exigences de vérificationCopier le lien de la section

Pour qu'un domaine soit vérifié (isVerified: true), SPF, DKIM et DMARC doivent tous être valid :

Vérification partielleCopier le lien de la section

Si certains enregistrements sont trouvés mais d'autres manquent, la réponse indique exactement ce qui nécessite attention :

{
  "domainId": "k3v9x2m8q1w7z4",
  "domain": "yourdomain.com",
  "isVerified": false,
  "spfStatus": "valid",
  "dkimStatus": "invalid",
  "dmarcStatus": "invalid",
  "message": "Domain verification incomplete. Please check DNS records below.",
  "dnsRecords": {
    "spfRecord": "v=spf1 include:spf.mlnd.net ~all",
    "dkimSelector": "mlnd",
    "dkimRecord": "v=DKIM1; k=rsa; p=MIIBIjANBgkq...",
    "dmarcRecord": "v=DMARC1; p=quarantine; pct=100; adkim=r; aspf=r; rua=mailto:[email protected]; sp=none"
  },
  "dkimErrorMessage": "DKIM record not found. Please add the TXT record to your DNS.",
  "dmarcErrorMessage": "DMARC record not found. Please add TXT record at _dmarc subdomain.",
  "trackingVerified": false,
  "trackingErrorMessage": "CNAME record not found. Please add a CNAME record for track.yourdomain.com pointing to track.mlnd.net",
  "bounceVerified": false,
  "mxVerified": false,
  "lastDnsCheckAt": "2026-02-17T10:20:00Z"
}

Re-vérification automatiqueCopier le lien de la section

MailLand re-vérifie périodiquement les domaines vérifiés en arrière-plan via le PendingDomainVerificationWorker et le DnsHealthCheckWorker :

• Domaines en attente : revérifiés toutes les heures pendant 7 jours après leur ajout ; ensuite, vérifiez manuellement
• Domaines vérifiés : la santé DNS est vérifiée périodiquement pour détecter les enregistrements supprimés ou modifiés

Si les enregistrements DNS d'un domaine vérifié sont ultérieurement supprimés ou modifiés, le statut de l'enregistrement concerné (spfStatus/dkimStatus/dmarcStatus) devient invalid, isFullyVerified devient false et l'envoi s'arrête jusqu'à ce que l'enregistrement soit corrigé. verificationStatus reste Verified : MailLand restaure automatiquement le statut de l'enregistrement dès que le DNS redevient correct.

Vérification de santé du domaineCopier le lien de la section

Exécutez une vérification de santé à la demande qui va au-delà de la vérification de base :

POST https://api.mail.land/v1/domains/{id}/health-check

curl -X POST https://api.mail.land/v1/domains/k3v9x2m8q1w7z4/health-check \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "domainName": "yourdomain.com",
  "status": "warning",
  "previousStatus": "healthy",
  "issues": [
    {
      "code": "DmarcNonePolicy",
      "message": "DMARC policy is set to 'none' (monitoring only)",
      "severity": "warning",
      "record": "DMARC",
      "details": "Consider upgrading to p=quarantine or p=reject"
    }
  ],
  "statusChanged": true,
  "checkedAt": "2026-02-17T10:30:00Z",
  "observationId": { "value": "3f2c9a1e-7b4d-4c1a-9e0f-5a6b7c8d9e0f" },
  "spf": {
    "lookupCompleted": true,
    "isValid": true,
    "value": "v=spf1 include:spf.mlnd.net ~all",
    "issues": [],
    "recordVerdict": "valid"
  },
  "dkim": {
    "lookupCompleted": true,
    "isValid": true,
    "issues": [],
    "recordVerdict": "valid"
  },
  "dmarc": {
    "lookupCompleted": true,
    "isValid": true,
    "value": "v=DMARC1; p=none; rua=mailto:[email protected]",
    "issues": [
      {
        "code": "DmarcNonePolicy",
        "message": "DMARC policy is set to 'none' (monitoring only)",
        "severity": "warning",
        "record": "DMARC",
        "details": "Consider upgrading to p=quarantine or p=reject"
      }
    ],
    "recordVerdict": "valid"
  }
}

Statuts de santéCopier le lien de la section

Codes d'erreurCopier le lien de la section

Historique de santéCopier le lien de la section

Consultez les résultats historiques des vérifications de santé. Les paramètres de requête optionnels from/to (dates ISO 8601) restreignent la plage :

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

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

[
  {
    "domainName": "yourdomain.com",
    "prevStatus": "healthy",
    "newStatus": "warning",
    "issues": ["DmarcNonePolicy"],
    "reason": "Scheduled health check",
    "checkedAt": "2026-02-17T10:30:00Z"
  },
  {
    "domainName": "yourdomain.com",
    "prevStatus": "warning",
    "newStatus": "healthy",
    "issues": [],
    "reason": "Scheduled health check",
    "checkedAt": "2026-02-16T10:30:00Z"
  }
]

La réponse est un tableau simple (pas d'enveloppe items, pas de nextCursor/hasMore).

DépannageCopier le lien de la section

Enregistrement SPF non trouvéCopier le lien de la section

• Assurez-vous d'avoir exactement un enregistrement TXT SPF sur votre domaine racine
• Plusieurs enregistrements SPF provoquent des échecs, fusionnez-les en un seul enregistrement
• Vérifiez que include:spf.mlnd.net apparaît avant le mécanisme ~all ou -all

Enregistrement DKIM non trouvéCopier le lien de la section

• Vérifiez que l'enregistrement est à mlnd._domainkey.yourdomain.com (pas mlnd._domainkey)
• Le type d'enregistrement doit être TXT (pas CNAME)
• Certains fournisseurs DNS nécessitent des guillemets autour des longues valeurs TXT
• Vérifiez les espaces ou sauts de ligne dans la clé publique collée

CNAME de chemin de retour non trouvéCopier le lien de la section

• Confirmez que le CNAME est à bounce.yourdomain.com (ou votre sous-domaine de rebond personnalisé)
• La valeur CNAME doit être bounce.mlnd.net (pas une adresse IP, ni un enregistrement MX)
• Utilisateurs Cloudflare : assurez-vous que le proxy est désactivé (nuage gris / DNS uniquement)

Délai de propagation DNSCopier le lien de la section

• La plupart des changements DNS se propagent en 5 à 15 minutes
• Si vous utilisez un faible TTL (300 s), les changements devraient apparaître rapidement
• Les enregistrements existants avec un TTL élevé peuvent prendre jusqu'à 48 heures pour se mettre à jour globalement
• Réessayez la vérification après avoir attendu 15 minutes

Étapes suivantesCopier le lien de la section

• Configuration DNS : examiner les enregistrements DNS requis
• Rotation des clés DKIM : faire pivoter les clés de signature DKIM
• REST API : commencer à envoyer des e-mails après la vérification