Domaines : DKIM
Annuler la mise à niveau DKIM
Abandonne la clé 2048 bits en attente. Le domaine continue de signer avec sa clé actuelle, comme avant.
https://g.sendcorex.com/v1/domaincommand: cancel_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.
Ne fonctionne qu'avant la publication et la bascule de la nouvelle clé. Après la bascule, il n'y a plus rien à annuler.
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: "cancel_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": "cancel_dkim_upgrade",
"id": "0",
"type": "SUCCESS",
"took_ms": 402,
"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": false,
"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.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=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu1SU1LfVLPHCozMxH2Mo4lgOEePzNm0tRgeLezV6ffAt0gunVTLw7onLRnrq0/IzW7yWR7QkrmBL7jTKEn5u+qKhbwKfBstIs+bMY2Zkp18gnTxKLxoS2tFczGkPLPgizskuemMghRniWaoLcyehkd3qqGElvW/VDL5AaWTg0nLVkjRo9z+40RQzuVaE8AkAFmxZzow3x+VJYKdjykkJ0iT9wCS0DRTXu269V264Vf/3jvredZiKRkgwlL9xNAwxXFg0x/XFw005UWVRIkdgcKWTjpBP2dPwVZ4WWC+9aGVd+Gyn1o0CLelf4rEjGoXbAAEgAqeGUxrcIlbjXfbcmwIDAQAB",
"split_value": "\"v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu1SU1LfVLPHCozMxH2Mo4lgOEePzNm0tRgeLezV6ffAt0gunVTLw7onLRnrq0/IzW7yWR7QkrmBL7jTKEn5u+qKhbwKfBstIs+bMY2Zkp18gnTxKLxoS2tFczGkPLPgizskuemMghRniWaoLcyehkd3qqGElvW/VDL5AaWTg0nLVkjRo9z+40RQzuVaE8AkAF\" \"mxZzow3x+VJYKdjykkJ0iT9wCS0DRTXu269V264Vf/3jvredZiKRkgwlL9xNAwxXFg0x/XFw005UWVRIkdgcKWTjpBP2dPwVZ4WWC+9aGVd+Gyn1o0CLelf4rEjGoXbAAEgAqeGUxrcIlbjXfbcmwIDAQAB\""
},
"mx": {
"type": "MX",
"host": "acme.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.com"
}
},
"spf_duplicate": false,
"spf_duplicate_records": [],
"dkim": {
"version": 1,
"key_size": 1024,
"selector": "sendcorex",
"deprecated": true,
"upgrade_pending": false,
"pending": null,
"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é.
Après l'annulation
L'enregistrement en attenteSi vous avez déjà publié l'enregistrement
sendcorex2, vous pouvez le supprimer.RecommencerStart DKIM Upgrade crée une toute nouvelle clé : publiez la nouvelle valeur renvoyée, pas l'ancienne.
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
NO_PENDING_UPGRADEIl n'y a aucune mise à niveau à annuler.
- 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.