Domaines : DKIM
Lancer la mise à niveau DKIM
Fait passer un domaine d'une clé DKIM 1024 bits à une clé 2048 bits sans interrompre vos envois. Crée la nouvelle clé sur un nouveau sélecteur et renvoie l'enregistrement à publier.
https://g.sendcorex.com/v1/domaincommand: start_dkim_upgradeNécessite le scope domain:create sur votre API key.
Jusqu'à 10 appels par minute et par compte. Au-delà, la commande répond RATE_LIMITED.
Peut être appelé deux fois sans risque : si une mise à niveau est déjà en cours, vous récupérez la même clé en attente.
Ne modifiez pas et ne supprimez pas l'enregistrement DKIM actuel. Ajoutez le nouveau à côté.
Arguments
domainstringobligatoireLe nom du domaine.
ex. :
"acme-mail.com"
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/domain',
{
commands: [
{
command: "start_dkim_upgrade",
args: {
domain: "acme-mail.com"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Réponse
{
"type": "SUCCESS",
"results": [
{
"command": "start_dkim_upgrade",
"id": "0",
"type": "SUCCESS",
"took_ms": 620,
"data": {
"domain": "acme-mail.com",
"validated": true,
"has_mx": true,
"has_spf": true,
"has_dkim": true,
"has_dmarc": true,
"has_return_path": true,
"description": null,
"dkim_key_size": 1024,
"dkim_deprecated": true,
"dkim_upgrade_pending": true,
"created_at": "2026-09-02T14:21:07.118Z",
"updated_at": "2026-10-21T02:40:51.902Z",
"registrar": "cloudflare",
"dns_records": {
"spf": {
"type": "TXT",
"host": "acme-mail.com",
"value": "v=spf1 include:_spf.google.com include:smtp.emailsbit.com ~all"
},
"dkim": {
"type": "TXT",
"host": "sendcorex._domainkey",
"value": "v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDCfGv4Yz2sTJHJ7BwjYjLlcHpL1OVJ0eA6Gg3Z3sQhZ2y1nI4S0Zl8q7vUJr5cQ1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6p7q8r9s0t1u2v3w4x5y6z7A8B9C0D1E2F3G4H5I6J7K8L9M0N1O2P3Q4R5S6T7U8V9W0X1Y2Z3wIDAQAB"
},
"dkim_pending": {
"type": "TXT",
"host": "sendcorex2._domainkey",
"value": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAw3v8Qk2Lr9sT1yH6pE0bN4cM7xZ2aJ5fG8dK1uV3oW9qR6tY0iS4eL2nB7mC5vX8zA1sD3fH6jK9lP0oI2uY4tR7eW1qA5sZ8xC3vB6nM9kL2jH5gF8dS1aP4oI7uY0tR3eW6qA9sZ2xC5vB8nM1kL4jH7gF0dS3aP6oI9uY2tR5eW8qA1sZ4xC7vB0nM3kL6jH9gF2dS5aP8oI1uY4tR7eW0qA3sZ6xC9vB2nM5kL8jH1gF4dS7aP0oI3uY6tR9eW2qA5sZ8xC1vB4nM7kL0jH3gF6dS9aP2oI5uY8tR1eW4qA7sZ0xC3vB6nM9QIDAQAB",
"split_value": "\"v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAw3v8Qk2Lr9sT1yH6pE0bN4cM7xZ2aJ5fG8dK1uV3oW9qR6tY0iS4eL2nB7mC5vX8zA1sD3fH6jK9lP0oI2uY4tR7eW1qA5sZ8xC3vB6nM9kL2jH5gF8dS1aP4oI7uY0tR3eW6qA9sZ2xC5vB8nM1kL4jH7gF0dS3aP6oI9uY2tR5eW8qA1sZ4xC7vB0nM3kL6\" \"jH9gF2dS5aP8oI1uY4tR7eW0qA3sZ6xC9vB2nM5kL8jH1gF4dS7aP0oI3uY6tR9eW2qA5sZ8xC1vB4nM7kL0jH3gF6dS9aP2oI5uY8tR1eW4qA7sZ0xC3vB6nM9QIDAQAB\""
},
"mx": {
"type": "MX",
"host": "acme-mail.com",
"value": "bounce.emailsbit.com",
"priority": 0
},
"return_path": {
"type": "CNAME",
"host": "bounces",
"value": "bounce.emailsbit.com"
},
"dmarc": {
"type": "TXT",
"host": "_dmarc",
"value": "v=DMARC1; p=quarantine; rua=mailto:dmarc@bounces.acme-mail.com"
}
},
"spf_duplicate": false,
"spf_duplicate_records": [],
"dkim": {
"version": 1,
"key_size": 1024,
"selector": "sendcorex",
"deprecated": true,
"upgrade_pending": true,
"pending": {
"selector": "sendcorex2",
"key_size": 2048,
"host": "sendcorex2._domainkey",
"full_host": "sendcorex2._domainkey.acme-mail.com",
"value": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAw3v8Qk2Lr9sT1yH6pE0bN4cM7xZ2aJ5fG8dK1uV3oW9qR6tY0iS4eL2nB7mC5vX8zA1sD3fH6jK9lP0oI2uY4tR7eW1qA5sZ8xC3vB6nM9kL2jH5gF8dS1aP4oI7uY0tR3eW6qA9sZ2xC5vB8nM1kL4jH7gF0dS3aP6oI9uY2tR5eW8qA1sZ4xC7vB0nM3kL6jH9gF2dS5aP8oI1uY4tR7eW0qA3sZ6xC9vB2nM5kL8jH1gF4dS7aP0oI3uY6tR9eW2qA5sZ8xC1vB4nM7kL0jH3gF6dS9aP2oI5uY8tR1eW4qA7sZ0xC3vB6nM9QIDAQAB",
"split_value": "\"v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAw3v8Qk2Lr9sT1yH6pE0bN4cM7xZ2aJ5fG8dK1uV3oW9qR6tY0iS4eL2nB7mC5vX8zA1sD3fH6jK9lP0oI2uY4tR7eW1qA5sZ8xC3vB6nM9kL2jH5gF8dS1aP4oI7uY0tR3eW6qA9sZ2xC5vB8nM1kL4jH7gF0dS3aP6oI9uY2tR5eW8qA1sZ4xC7vB0nM3kL6\" \"jH9gF2dS5aP8oI1uY4tR7eW0qA3sZ6xC9vB2nM5kL8jH1gF4dS7aP0oI3uY6tR9eW2qA5sZ8xC1vB4nM7kL0jH3gF6dS9aP2oI5uY8tR1eW4qA7sZ0xC3vB6nM9QIDAQAB\"",
"created_at": "2026-10-21T03:10:44.205Z"
},
"previous_selector": null,
"keep_old_record_until": null,
"just_upgraded": false
}
}
}
]
}Champs de la réponse
domainLe nom du domaine, en minuscules. C'est l'id que vous utilisez dans toutes les autres commandes.
validatedtruedès que le CNAME du Return-Path et l'enregistrement DKIM ont été trouvés. Seuls les domaines validés peuvent avoir des senders.has_mxL'enregistrement MX pointe vers
bounce.emailsbit.com. Facultatif : nécessaire uniquement pour recevoir les réponses et les bounces sur le domaine lui-même.has_spfVotre SPF contient
include:smtp.emailsbit.com.has_dkimL'enregistrement TXT DKIM avec votre clé publique est publié.
has_dmarcUn enregistrement DMARC existe sur
_dmarc.<domain>.has_return_pathLe CNAME du Return-Path (
bounces.<domain>→bounce.emailsbit.com) est publié. Les bounces et l'alignement SPF en dépendent.descriptionVotre propre note sur le domaine, ou
null.dkim_key_size2048ou1024.nullsi le domaine n'a pas encore de clé.dkim_deprecatedtruepour les clés 1024 bits. Certains fournisseurs les considèrent déjà comme faibles : passez à la version supérieure avec Start DKIM Upgrade.dkim_upgrade_pendingtruetant qu'une nouvelle clé 2048 bits attend son enregistrement DNS.created_at / updated_atISO 8601, UTC.
registrarOù le DNS est hébergé, d'après ses serveurs de noms :
cloudflare,namecheap,godaddy,route53,google,vercel,hostinger,ionos,hetzner,dreamhost,squarespace,registrobrouother.dns_records.spf / dkim / mx / return_path / dmarcLes enregistrements à publier. Chacun a
type,hostetvalue. Voir Enregistrements DNS ci-dessous.dns_records.dkim_pendingUniquement pendant une mise à niveau DKIM : le nouvel enregistrement 2048 bits. Publiez-le à côté de l'actuel.
dns_records.*.split_valueUniquement pour les valeurs TXT de plus de 255 caractères : la même valeur déjà découpée en chaînes entre guillemets, pour les panneaux DNS qui l'exigent.
dns_records.mx.priorityToujours
0.spf_duplicatetruequand le domaine a plus d'un enregistrement SPF. C'est invalide : SPF échoue chez tous les destinataires tant que vous ne les fusionnez pas en un seul.spf_duplicate_recordsLes enregistrements SPF trouvés, pour vous aider à les fusionner.
dkimLa clé DKIM utilisée et toute mise à niveau en cours. Voir DKIM ci-dessous.
dkim.version2pour les clés 2048 bits,1pour 1024.dkim.key_sizeLa taille de la clé qui signe actuellement vos emails.
dkim.selectorLe sélecteur de la clé utilisée : le
s=du header DKIM-Signature.dkim.deprecatedtruepour les clés 1024 bits.dkim.upgrade_pendingtruetant qu'une nouvelle clé attend son enregistrement DNS.dkim.pendingLa nouvelle clé :
selector,key_size,host,full_host,value,split_value,created_at.nulls'il n'y a pas de mise à niveau.dkim.previous_selectorPendant 48 heures après une mise à niveau : l'ancien sélecteur. Gardez son enregistrement jusqu'à
keep_old_record_until, puis vous pouvez le supprimer.dkim.keep_old_record_untilQuand l'ancien enregistrement peut être supprimé.
nulls'il n'y a rien à supprimer.dkim.just_upgradedtrueuniquement lors de l'appel qui a basculé vers la nouvelle clé.
Fonctionnement de la mise à niveau
Vos emails sont signés avec l'ancienne clé tout du long, jusqu'à ce que la nouvelle soit dans le DNS.
1. DémarrerCette commande. La nouvelle clé va dans
dkim.pendingetdns_records.dkim_pending(sélecteursendcorex2).2. PublierCréez l'enregistrement TXT
dkim_pending. Gardez l'ancien.3. VérifierAppelez Get Domain. Dès que le nouvel enregistrement est trouvé, la nouvelle clé commence à signer (
dkim.just_upgradedvauttruelors de cet appel).4. NettoyerGardez l'ancien enregistrement jusqu'à
dkim.keep_old_record_until(48 heures), pour que les emails encore en transit restent valides, puis supprimez-le.
Erreurs
Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.
- 401
INVALID_API_KEYL'API key n'existe pas, a été révoquée ou désactivée dans le dashboard.
- 429
RATE_LIMITEDPlus de 15 requêtes/s ou 15 simultanées pour la même IP + API key. Attendez le nombre de secondes indiqué dans Retry-After.
- CMD
MISSING_SCOPEL'API key n'a pas le scope requis par cette commande.
- CMD
INVALID_ARGSUn argument est invalide : `domain` manquant ou mal formé, `key_size` autre que 1024/2048, `email` invalide, une description de plus de 255 caractères…
- CMD
DOMAIN_NOT_FOUNDLe domaine n'est pas sur votre compte.
- CMD
DKIM_NOT_FOUNDLe domaine n'a pas de clé DKIM.
- CMD
ALREADY_UPGRADEDLe domaine utilise déjà une clé 2048 bits.
- CMD
DKIM_GENERATION_FAILEDLa clé DKIM n'a pas pu être créée. Rien n'a été enregistré. Réessayez.
- CMD
RATE_LIMITEDCette commande a été appelée trop de fois par votre compte au cours de la dernière minute. Attendez une minute.
- CMD
INTERNALErreur serveur. Le détail n'est écrit que dans le log du serveur.