Dominios: DKIM
Cancelar actualización de DKIM
Descarta la clave de 2048 bits pendiente. El dominio sigue firmando con su clave actual, como antes.
https://g.sendcorex.com/v1/domaincommand: cancel_dkim_upgradeNecesita el scope domain:create en tu API key.
Hasta 10 llamadas por minuto por cuenta. Por encima, el comando responde RATE_LIMITED.
Solo funciona antes de que la clave nueva se publique y se active. Después del cambio no hay nada que cancelar.
Argumentos
domainstringobligatorioEl nombre del dominio.
p. ej.
"acme-mail.com"
Inicio rápido
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);Respuesta
{
"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
}
}
}
]
}Campos de la respuesta
domainEl nombre del dominio, en minúsculas. Es el id que usas en todos los demás comandos.
validatedtrueen cuanto se encuentran el CNAME del Return-Path y el registro DKIM. Solo los dominios validados pueden tener senders.has_mxEl registro MX apunta a
bounce.emailsbit.com. Opcional: solo hace falta para recibir respuestas y rebotes en el propio dominio.has_spfTu SPF incluye
include:smtp.emailsbit.com.has_dkimEl registro TXT de DKIM con tu clave pública está publicado.
has_dmarcExiste un registro DMARC en
_dmarc.<domain>.has_return_pathEl CNAME del Return-Path (
bounces.<domain>→bounce.emailsbit.com) está publicado. Los rebotes y la alineación SPF dependen de él.descriptionTu propia nota sobre el dominio, o
null.dkim_key_size2048o1024.nullsi el dominio aún no tiene clave.dkim_deprecatedtruepara claves de 1024 bits. Algunos proveedores ya las consideran débiles: actualiza con Start DKIM Upgrade.dkim_upgrade_pendingtruemientras una clave nueva de 2048 bits espera su registro DNS.created_at / updated_atISO 8601, UTC.
registrarDónde está alojado el DNS, según sus nameservers:
cloudflare,namecheap,godaddy,route53,google,vercel,hostinger,ionos,hetzner,dreamhost,squarespace,registrobruother.dns_records.spf / dkim / mx / return_path / dmarcLos registros que hay que publicar. Cada uno tiene
type,hostyvalue. Consulta Registros DNS más abajo.dns_records.dkim_pendingSolo durante una actualización de DKIM: el nuevo registro de 2048 bits. Publícalo junto al actual.
dns_records.*.split_valueSolo para valores TXT de más de 255 caracteres: el mismo valor ya dividido en cadenas entre comillas, para los paneles DNS que lo necesitan.
dns_records.mx.prioritySiempre
0.spf_duplicatetruecuando el dominio tiene más de un registro SPF. Eso no es válido: el SPF falla para todos los receptores hasta que los unas en uno solo.spf_duplicate_recordsLos registros SPF encontrados, para ayudarte a unirlos.
dkimLa clave DKIM en uso y cualquier actualización en curso. Consulta DKIM más abajo.
dkim.version2para claves de 2048 bits,1para 1024.dkim.key_sizeEl tamaño de la clave que firma tus emails ahora.
dkim.selectorEl selector de la clave en uso: el
s=del header DKIM-Signature.dkim.deprecatedtruepara claves de 1024 bits.dkim.upgrade_pendingtruemientras una clave nueva espera su registro DNS.dkim.pendingLa clave nueva:
selector,key_size,host,full_host,value,split_value,created_at.nullcuando no hay actualización.dkim.previous_selectorDurante 48 horas después de una actualización: el selector anterior. Conserva su registro hasta
keep_old_record_untily luego puedes quitarlo.dkim.keep_old_record_untilCuándo se puede quitar el registro anterior.
nullcuando no hay nada que quitar.dkim.just_upgradedtruesolo en la llamada que cambió a la clave nueva.
Después de cancelar
El registro pendienteSi ya publicaste el registro
sendcorex2, puedes quitarlo.Empezar de nuevoStart DKIM Upgrade crea una clave totalmente nueva: publica el nuevo valor que devuelve, no el anterior.
Errores
Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.
- 401
INVALID_API_KEYLa API key no existe, se revocó o se desactivó en el dashboard.
- 429
RATE_LIMITEDMás de 15 peticiones/s o 15 simultáneas para la misma IP + API key. Espera los segundos indicados en Retry-After.
- CMD
MISSING_SCOPELa API key no tiene el scope que necesita este comando.
- CMD
INVALID_ARGSUn argumento no es válido: `domain` ausente o con formato incorrecto, `key_size` distinto de 1024/2048, `email` inválido, una descripción de más de 255 caracteres…
- CMD
DOMAIN_NOT_FOUNDEl dominio no está en tu cuenta.
- CMD
DKIM_NOT_FOUNDEl dominio no tiene clave DKIM.
- CMD
NO_PENDING_UPGRADENo hay ninguna actualización que cancelar.
- CMD
RATE_LIMITEDTu cuenta llamó a este comando demasiadas veces en el último minuto. Espera un minuto.
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.