Domínios: DKIM

Cancelar upgrade de DKIM

Descarta a chave de 2048 bits pendente. O domínio continua assinando com a chave atual, como antes.

POSThttps://g.sendcorex.com/v1/domaincommand: cancel_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

Só funciona antes de a chave nova ser publicada e ativada. Depois da troca não há nada a cancelar.

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: "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);

Resposta

{
  "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 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.

Depois de cancelar

  • O registro pendente

    Se você já publicou o registro sendcorex2, pode removê-lo.

  • Começar de novo

    Start DKIM Upgrade cria uma chave totalmente nova: publique o novo valor que ele retornar, não o antigo.

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.

  • CMDNO_PENDING_UPGRADE

    Não há upgrade a cancelar.

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