Domain: DKIM
Batalkan upgrade DKIM
Membatalkan key 2048-bit yang tertunda. Domain tetap menandatangani dengan key saat ini, seperti sebelumnya.
https://g.sendcorex.com/v1/domaincommand: cancel_dkim_upgradeMembutuhkan scope domain:create pada API key Anda.
Hingga 10 panggilan per menit per akun. Jika melebihi, perintah menjawab RATE_LIMITED.
Hanya berfungsi sebelum key baru dipublikasikan dan dialihkan. Setelah dialihkan, tidak ada yang bisa dibatalkan.
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: "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);Respons
{
"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
}
}
}
]
}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.
Setelah membatalkan
Record yang tertundaJika Anda sudah memublikasikan record
sendcorex2, Anda bisa menghapusnya.Memulai lagiStart DKIM Upgrade membuat key yang benar-benar baru: publikasikan nilai baru yang dikembalikannya, bukan yang lama.
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
NO_PENDING_UPGRADETidak ada upgrade yang bisa dibatalkan.
- 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.