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.
https://g.sendcorex.com/v1/domaincommand: start_dkim_upgradePrecisa do scope domain:create na sua API key.
Até 10 chamadas por minuto por conta. Acima disso, o comando responde RATE_LIMITED.
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órioO 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
domainO nome do domínio, em minúsculas. É o id que você usa em todos os outros comandos.
validatedtrueassim que o CNAME do Return-Path e o registro DKIM forem encontrados. Só domínios validados podem ter senders.has_mxO registro MX aponta para
bounce.emailsbit.com. Opcional: só é necessário para receber respostas e bounces no próprio domínio.has_spfSeu SPF inclui
include:smtp.emailsbit.com.has_dkimO registro TXT do DKIM com sua chave pública está publicado.
has_dmarcExiste um registro DMARC em
_dmarc.<domain>.has_return_pathO CNAME do Return-Path (
bounces.<domain>→bounce.emailsbit.com) está publicado. Bounces e o alinhamento de SPF dependem dele.descriptionSua própria nota sobre o domínio, ou
null.dkim_key_size2048ou1024.nullse o domínio ainda não tem chave.dkim_deprecatedtruepara chaves de 1024 bits. Alguns provedores já as tratam como fracas: faça o upgrade com Start DKIM Upgrade.dkim_upgrade_pendingtrueenquanto uma nova chave de 2048 bits aguarda seu registro DNS.created_at / updated_atISO 8601, UTC.
registrarOnde o DNS está hospedado, pelos nameservers:
cloudflare,namecheap,godaddy,route53,google,vercel,hostinger,ionos,hetzner,dreamhost,squarespace,registrobrouother.dns_records.spf / dkim / mx / return_path / dmarcOs registros a publicar. Cada um tem
type,hostevalue. Veja Registros DNS abaixo.dns_records.dkim_pendingSó durante um upgrade de DKIM: o novo registro de 2048 bits. Publique ao lado do atual.
dns_records.*.split_valueSó 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.prioritySempre
0.spf_duplicatetruequando 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_recordsOs registros SPF encontrados, para ajudar você a juntá-los.
dkimA chave DKIM em uso e qualquer upgrade em andamento. Veja DKIM abaixo.
dkim.version2para chaves de 2048 bits,1para 1024.dkim.key_sizeO tamanho da chave que assina seus emails agora.
dkim.selectorO seletor da chave em uso: o
s=no header DKIM-Signature.dkim.deprecatedtruepara chaves de 1024 bits.dkim.upgrade_pendingtrueenquanto uma nova chave aguarda seu registro DNS.dkim.pendingA chave nova:
selector,key_size,host,full_host,value,split_value,created_at.nullquando não há upgrade.dkim.previous_selectorDurante 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_untilQuando o registro antigo pode ser removido.
nullquando não há nada a remover.dkim.just_upgradedtruesó 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. IniciarEste comando. A chave nova vai para
dkim.pendingedns_records.dkim_pending(seletorsendcorex2).2. PublicarCrie o registro TXT
dkim_pending. Mantenha o antigo.3. VerificarChame Get Domain. Assim que o registro novo for encontrado, a chave nova passa a assinar (
dkim.just_upgradedvemtruenessa chamada).4. LimparMantenha 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.
- 401
INVALID_API_KEYA API key não existe, foi revogada ou foi desativada no dashboard.
- 429
RATE_LIMITEDMais de 15 requests/s ou 15 simultâneos para o mesmo IP + API key. Espere o número de segundos em Retry-After.
- CMD
MISSING_SCOPEA API key não tem o scope que este comando precisa.
- CMD
INVALID_ARGSUm argumento é inválido: `domain` ausente ou malformado, `key_size` diferente de 1024/2048, `email` inválido, uma descrição com mais de 255 caracteres…
- CMD
DOMAIN_NOT_FOUNDO domínio não está na sua conta.
- CMD
DKIM_NOT_FOUNDO domínio não tem chave DKIM.
- CMD
ALREADY_UPGRADEDO domínio já usa uma chave de 2048 bits.
- CMD
DKIM_GENERATION_FAILEDA chave DKIM não pôde ser criada. Nada foi salvo. Tente de novo.
- CMD
RATE_LIMITEDEste comando foi chamado vezes demais no último minuto pela sua conta. Espere um minuto.
- CMD
INTERNALErro no servidor. O detalhe só é gravado no log do servidor.