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.

POSThttps://g.sendcorex.com/v1/domaincommand: start_dkim_upgrade
i

Necesita el scope domain:create en tu API key.

i

Hasta 10 llamadas por minuto por cuenta. Por encima, el comando responde RATE_LIMITED.

i

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

  • domainstringobligatorio

    El 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

  • domain

    El nombre del dominio, en minúsculas. Es el id que usas en todos los demás comandos.

  • validated

    true en cuanto se encuentran el CNAME del Return-Path y el registro DKIM. Solo los dominios validados pueden tener senders.

  • has_mx

    El registro MX apunta a bounce.emailsbit.com. Opcional: solo hace falta para recibir respuestas y rebotes en el propio dominio.

  • has_spf

    Tu SPF incluye include:smtp.emailsbit.com.

  • has_dkim

    El registro TXT de DKIM con tu clave pública está publicado.

  • has_dmarc

    Existe un registro DMARC en _dmarc.<domain>.

  • has_return_path

    El CNAME del Return-Path (bounces.<domain> → bounce.emailsbit.com) está publicado. Los rebotes y la alineación SPF dependen de él.

  • description

    Tu propia nota sobre el dominio, o null.

  • dkim_key_size

    2048 o 1024. null si el dominio aún no tiene clave.

  • dkim_deprecated

    true para claves de 1024 bits. Algunos proveedores ya las consideran débiles: actualiza con Start DKIM Upgrade.

  • dkim_upgrade_pending

    true mientras una clave nueva de 2048 bits espera su registro DNS.

  • created_at / updated_at

    ISO 8601, UTC.

  • registrar

    Dónde está alojado el DNS, según sus nameservers: cloudflare, namecheap, godaddy, route53, google, vercel, hostinger, ionos, hetzner, dreamhost, squarespace, registrobr u other.

  • dns_records.spf / dkim / mx / return_path / dmarc

    Los registros que hay que publicar. Cada uno tiene type, host y value. Consulta Registros DNS más abajo.

  • dns_records.dkim_pending

    Solo durante una actualización de DKIM: el nuevo registro de 2048 bits. Publícalo junto al actual.

  • dns_records.*.split_value

    Solo 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.priority

    Siempre 0.

  • spf_duplicate

    true cuando 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_records

    Los registros SPF encontrados, para ayudarte a unirlos.

  • dkim

    La clave DKIM en uso y cualquier actualización en curso. Consulta DKIM más abajo.

  • dkim.version

    2 para claves de 2048 bits, 1 para 1024.

  • dkim.key_size

    El tamaño de la clave que firma tus emails ahora.

  • dkim.selector

    El selector de la clave en uso: el s= del header DKIM-Signature.

  • dkim.deprecated

    true para claves de 1024 bits.

  • dkim.upgrade_pending

    true mientras una clave nueva espera su registro DNS.

  • dkim.pending

    La clave nueva: selector, key_size, host, full_host, value, split_value, created_at. null cuando no hay actualización.

  • dkim.previous_selector

    Durante 48 horas después de una actualización: el selector anterior. Conserva su registro hasta keep_old_record_until y luego puedes quitarlo.

  • dkim.keep_old_record_until

    Cuándo se puede quitar el registro anterior. null cuando no hay nada que quitar.

  • dkim.just_upgraded

    true solo 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. Iniciar

    Este comando. La clave nueva va a dkim.pending y dns_records.dkim_pending (selector sendcorex2).

  • 2. Publicar

    Crea el registro TXT dkim_pending. Conserva el anterior.

  • 3. Comprobar

    Llama a Get Domain. En cuanto se encuentra el registro nuevo, la clave nueva empieza a firmar (dkim.just_upgraded es true en esa llamada).

  • 4. Limpiar

    Conserva 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.

  • 401INVALID_API_KEY

    La API key no existe, se revocó o se desactivó en el dashboard.

  • 429RATE_LIMITED

    Más de 15 peticiones/s o 15 simultáneas para la misma IP + API key. Espera los segundos indicados en Retry-After.

  • CMDMISSING_SCOPE

    La API key no tiene el scope que necesita este comando.

  • CMDINVALID_ARGS

    Un 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…

  • CMDDOMAIN_NOT_FOUND

    El dominio no está en tu cuenta.

  • CMDDKIM_NOT_FOUND

    El dominio no tiene clave DKIM.

  • CMDALREADY_UPGRADED

    El dominio ya usa una clave de 2048 bits.

  • CMDDKIM_GENERATION_FAILED

    No se pudo crear la clave DKIM. No se guardó nada. Inténtalo de nuevo.

  • CMDRATE_LIMITED

    Tu cuenta llamó a este comando demasiadas veces en el último minuto. Espera un minuto.

  • CMDINTERNAL

    Error del servidor. El detalle solo se escribe en el log del servidor.