Dominios: DKIM
Iniciar actualización de DKIM
Pasa un dominio de una clave DKIM de 1024 bits a una de 2048 bits sin detener tus envíos. Crea la clave nueva en un selector nuevo y devuelve el registro que hay que publicar.
https://g.sendcorex.com/v1/domaincommand: start_dkim_upgradeNecesita el scope domain:create en tu API key.
Hasta 10 llamadas por minuto por cuenta. Por encima, el comando responde RATE_LIMITED.
Puedes llamarlo dos veces: si ya hay una actualización en curso, recibes la misma clave pendiente.
No edites ni quites el registro DKIM actual. Añade el nuevo junto a él.
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: "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);Respuesta
{
"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
}
}
}
]
}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.
Cómo funciona la actualización
Tus emails se firman con la clave anterior todo el tiempo, hasta que la nueva esté en el DNS.
1. IniciarEste comando. La clave nueva va a
dkim.pendingydns_records.dkim_pending(selectorsendcorex2).2. PublicarCrea el registro TXT
dkim_pending. Conserva el anterior.3. ComprobarLlama a Get Domain. En cuanto se encuentra el registro nuevo, la clave nueva empieza a firmar (
dkim.just_upgradedestrueen esa llamada).4. LimpiarConserva el registro anterior hasta
dkim.keep_old_record_until(48 horas), para que los emails aún en tránsito sigan pasando, y luego quítalo.
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
ALREADY_UPGRADEDEl dominio ya usa una clave de 2048 bits.
- CMD
DKIM_GENERATION_FAILEDNo se pudo crear la clave DKIM. No se guardó nada. Inténtalo de nuevo.
- 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.