Domínios: DKIM

Iniciar upgrade de DKIM

Migra um domínio de uma chave DKIM de 1024 bits para uma de 2048 bits sem parar seus envios. Cria a chave nova em um novo seletor e retorna o registro a publicar.

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

Precisa do scope domain:create na sua API key.

i

Até 10 chamadas por minuto por conta. Acima disso, o comando responde RATE_LIMITED.

i

Pode chamar duas vezes: se já houver um upgrade em andamento, você recebe a mesma chave pendente.

!

Não edite nem remova o registro DKIM atual. Adicione o novo ao lado dele.

Argumentos

  • domainstringobrigatório

    O nome do domínio.

    ex.: "acme-mail.com"

Início 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);

Resposta

{
  "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 da resposta

  • domain

    O nome do domínio, em minúsculas. É o id que você usa em todos os outros comandos.

  • validated

    true assim que o CNAME do Return-Path e o registro DKIM forem encontrados. Só domínios validados podem ter senders.

  • has_mx

    O registro MX aponta para bounce.emailsbit.com. Opcional: só é necessário para receber respostas e bounces no próprio domínio.

  • has_spf

    Seu SPF inclui include:smtp.emailsbit.com.

  • has_dkim

    O registro TXT do DKIM com sua chave pública está publicado.

  • has_dmarc

    Existe um registro DMARC em _dmarc.<domain>.

  • has_return_path

    O CNAME do Return-Path (bounces.<domain> → bounce.emailsbit.com) está publicado. Bounces e o alinhamento de SPF dependem dele.

  • description

    Sua própria nota sobre o domínio, ou null.

  • dkim_key_size

    2048 ou 1024. null se o domínio ainda não tem chave.

  • dkim_deprecated

    true para chaves de 1024 bits. Alguns provedores já as tratam como fracas: faça o upgrade com Start DKIM Upgrade.

  • dkim_upgrade_pending

    true enquanto uma nova chave de 2048 bits aguarda seu registro DNS.

  • created_at / updated_at

    ISO 8601, UTC.

  • registrar

    Onde o DNS está hospedado, pelos nameservers: cloudflare, namecheap, godaddy, route53, google, vercel, hostinger, ionos, hetzner, dreamhost, squarespace, registrobr ou other.

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

    Os registros a publicar. Cada um tem type, host e value. Veja Registros DNS abaixo.

  • dns_records.dkim_pending

    Só durante um upgrade de DKIM: o novo registro de 2048 bits. Publique ao lado do atual.

  • dns_records.*.split_value

    Só para valores TXT com mais de 255 caracteres: o mesmo valor já dividido em strings entre aspas, para painéis DNS que exigem isso.

  • dns_records.mx.priority

    Sempre 0.

  • spf_duplicate

    true quando o domínio tem mais de um registro SPF. Isso é inválido: o SPF falha para todos os destinatários até você juntá-los em um só.

  • spf_duplicate_records

    Os registros SPF encontrados, para ajudar você a juntá-los.

  • dkim

    A chave DKIM em uso e qualquer upgrade em andamento. Veja DKIM abaixo.

  • dkim.version

    2 para chaves de 2048 bits, 1 para 1024.

  • dkim.key_size

    O tamanho da chave que assina seus emails agora.

  • dkim.selector

    O seletor da chave em uso: o s= no header DKIM-Signature.

  • dkim.deprecated

    true para chaves de 1024 bits.

  • dkim.upgrade_pending

    true enquanto uma nova chave aguarda seu registro DNS.

  • dkim.pending

    A chave nova: selector, key_size, host, full_host, value, split_value, created_at. null quando não há upgrade.

  • dkim.previous_selector

    Durante 48 horas após um upgrade: o seletor antigo. Mantenha o registro dele até keep_old_record_until, depois pode removê-lo.

  • dkim.keep_old_record_until

    Quando o registro antigo pode ser removido. null quando não há nada a remover.

  • dkim.just_upgraded

    true só na chamada que trocou para a chave nova.

Como o upgrade funciona

Seus emails são assinados com a chave antiga o tempo todo, até a nova estar no DNS.

  • 1. Iniciar

    Este comando. A chave nova vai para dkim.pending e dns_records.dkim_pending (seletor sendcorex2).

  • 2. Publicar

    Crie o registro TXT dkim_pending. Mantenha o antigo.

  • 3. Verificar

    Chame Get Domain. Assim que o registro novo for encontrado, a chave nova passa a assinar (dkim.just_upgraded vem true nessa chamada).

  • 4. Limpar

    Mantenha o registro antigo até dkim.keep_old_record_until (48 horas), para que emails ainda em trânsito continuem passando, e depois remova-o.

Erros

Erros no nível HTTP retornam type, code e message. Erros marcados com CMD voltam dentro do resultado do comando, com HTTP 200.

  • 401INVALID_API_KEY

    A API key não existe, foi revogada ou foi desativada no dashboard.

  • 429RATE_LIMITED

    Mais de 15 requests/s ou 15 simultâneos para o mesmo IP + API key. Espere o número de segundos em Retry-After.

  • CMDMISSING_SCOPE

    A API key não tem o scope que este comando precisa.

  • CMDINVALID_ARGS

    Um argumento é inválido: `domain` ausente ou malformado, `key_size` diferente de 1024/2048, `email` inválido, uma descrição com mais de 255 caracteres…

  • CMDDOMAIN_NOT_FOUND

    O domínio não está na sua conta.

  • CMDDKIM_NOT_FOUND

    O domínio não tem chave DKIM.

  • CMDALREADY_UPGRADED

    O domínio já usa uma chave de 2048 bits.

  • CMDDKIM_GENERATION_FAILED

    A chave DKIM não pôde ser criada. Nada foi salvo. Tente de novo.

  • CMDRATE_LIMITED

    Este comando foi chamado vezes demais no último minuto pela sua conta. Espere um minuto.

  • CMDINTERNAL

    Erro no servidor. O detalhe só é gravado no log do servidor.