Domain: DKIM
Mulai upgrade DKIM
Memindahkan domain dari key DKIM 1024-bit ke 2048-bit tanpa menghentikan pengiriman Anda. Membuat key baru pada selector baru dan mengembalikan record yang perlu dipublikasikan.
https://g.sendcorex.com/v1/domaincommand: start_dkim_upgradeMembutuhkan scope domain:create pada API key Anda.
Hingga 10 panggilan per menit per akun. Jika melebihi, perintah menjawab RATE_LIMITED.
Aman dipanggil dua kali: jika upgrade sudah berjalan, Anda mendapatkan key tertunda yang sama.
Jangan ubah atau hapus record DKIM saat ini. Tambahkan yang baru di sampingnya.
Argumen
domainstringwajibNama domain.
mis.
"acme-mail.com"
Mulai cepat
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);Respons
{
"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
}
}
}
]
}Field respons
domainNama domain, dalam huruf kecil. Ini id yang Anda gunakan di semua perintah lain.
validatedtruesetelah CNAME Return-Path dan record DKIM ditemukan. Hanya domain tervalidasi yang dapat memiliki sender.has_mxRecord MX mengarah ke
bounce.emailsbit.com. Opsional: hanya diperlukan untuk menerima balasan dan bounce di domain itu sendiri.has_spfSPF Anda menyertakan
include:smtp.emailsbit.com.has_dkimRecord TXT DKIM dengan public key Anda sudah dipublikasikan.
has_dmarcRecord DMARC ada di
_dmarc.<domain>.has_return_pathCNAME Return-Path (
bounces.<domain>→bounce.emailsbit.com) sudah dipublikasikan. Bounce dan keselarasan SPF bergantung padanya.descriptionCatatan Anda sendiri tentang domain, atau
null.dkim_key_size2048atau1024.nulljika domain belum memiliki key.dkim_deprecatedtrueuntuk key 1024-bit. Beberapa provider sudah menganggapnya lemah: lakukan upgrade dengan Start DKIM Upgrade.dkim_upgrade_pendingtrueselama key 2048-bit baru menunggu record DNS-nya.created_at / updated_atISO 8601, UTC.
registrarLokasi hosting DNS, berdasarkan nameserver-nya:
cloudflare,namecheap,godaddy,route53,google,vercel,hostinger,ionos,hetzner,dreamhost,squarespace,registrobr, atauother.dns_records.spf / dkim / mx / return_path / dmarcRecord yang perlu dipublikasikan. Masing-masing memiliki
type,host, danvalue. Lihat Record DNS di bawah.dns_records.dkim_pendingHanya selama upgrade DKIM: record 2048-bit yang baru. Publikasikan di samping yang saat ini.
dns_records.*.split_valueHanya untuk nilai TXT lebih dari 255 karakter: nilai yang sama sudah dipecah menjadi string berkutip, untuk panel DNS yang memerlukannya.
dns_records.mx.prioritySelalu
0.spf_duplicatetruejika domain memiliki lebih dari satu record SPF. Itu tidak valid: SPF gagal di semua penerima sampai Anda menggabungkannya menjadi satu.spf_duplicate_recordsRecord SPF yang ditemukan, untuk membantu Anda menggabungkannya.
dkimKey DKIM yang digunakan dan upgrade yang sedang berjalan. Lihat DKIM di bawah.
dkim.version2untuk key 2048-bit,1untuk 1024.dkim.key_sizeUkuran key yang saat ini menandatangani email Anda.
dkim.selectorSelector key yang digunakan:
s=di header DKIM-Signature.dkim.deprecatedtrueuntuk key 1024-bit.dkim.upgrade_pendingtrueselama key baru menunggu record DNS-nya.dkim.pendingKey baru:
selector,key_size,host,full_host,value,split_value,created_at.nulljika tidak ada upgrade.dkim.previous_selectorSelama 48 jam setelah upgrade: selector lama. Pertahankan record-nya hingga
keep_old_record_until, lalu Anda bisa menghapusnya.dkim.keep_old_record_untilKapan record lama boleh dihapus.
nulljika tidak ada yang perlu dihapus.dkim.just_upgradedtruehanya pada panggilan yang beralih ke key baru.
Cara kerja upgrade
Email Anda ditandatangani dengan key lama sepanjang waktu, sampai key baru ada di DNS.
1. MulaiPerintah ini. Key baru masuk ke
dkim.pendingdandns_records.dkim_pending(selectorsendcorex2).2. PublikasikanBuat record TXT
dkim_pending. Pertahankan yang lama.3. PeriksaPanggil Get Domain. Begitu record baru ditemukan, key baru mulai menandatangani (
dkim.just_upgradedbernilaitruepada panggilan itu).4. BersihkanPertahankan record lama hingga
dkim.keep_old_record_until(48 jam), agar email yang masih dalam perjalanan tetap lolos, lalu hapus.
Error
Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.
- 401
INVALID_API_KEYAPI key tidak ada, sudah dicabut, atau dinonaktifkan di dashboard.
- 429
RATE_LIMITEDLebih dari 15 request/detik atau 15 bersamaan untuk IP + API key yang sama. Tunggu sesuai jumlah detik di Retry-After.
- CMD
MISSING_SCOPEAPI key tidak memiliki scope yang dibutuhkan perintah ini.
- CMD
INVALID_ARGSAda argumen yang tidak valid: `domain` tidak ada atau salah format, `key_size` selain 1024/2048, `email` tidak valid, deskripsi lebih dari 255 karakter…
- CMD
DOMAIN_NOT_FOUNDDomain tidak ada di akun Anda.
- CMD
DKIM_NOT_FOUNDDomain tidak memiliki key DKIM.
- CMD
ALREADY_UPGRADEDDomain sudah menggunakan key 2048-bit.
- CMD
DKIM_GENERATION_FAILEDKey DKIM tidak dapat dibuat. Tidak ada yang disimpan. Coba lagi.
- CMD
RATE_LIMITEDPerintah ini dipanggil terlalu sering oleh akun Anda dalam satu menit terakhir. Tunggu satu menit.
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.