Domain: DKIM

Batalkan upgrade DKIM

Membatalkan key 2048-bit yang tertunda. Domain tetap menandatangani dengan key saat ini, seperti sebelumnya.

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

Membutuhkan scope domain:create pada API key Anda.

i

Hingga 10 panggilan per menit per akun. Jika melebihi, perintah menjawab RATE_LIMITED.

i

Hanya berfungsi sebelum key baru dipublikasikan dan dialihkan. Setelah dialihkan, tidak ada yang bisa dibatalkan.

Argumen

  • domainstringwajib

    Nama 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

  • domain

    Nama domain, dalam huruf kecil. Ini id yang Anda gunakan di semua perintah lain.

  • validated

    true setelah CNAME Return-Path dan record DKIM ditemukan. Hanya domain tervalidasi yang dapat memiliki sender.

  • has_mx

    Record MX mengarah ke bounce.emailsbit.com. Opsional: hanya diperlukan untuk menerima balasan dan bounce di domain itu sendiri.

  • has_spf

    SPF Anda menyertakan include:smtp.emailsbit.com.

  • has_dkim

    Record TXT DKIM dengan public key Anda sudah dipublikasikan.

  • has_dmarc

    Record DMARC ada di _dmarc.<domain>.

  • has_return_path

    CNAME Return-Path (bounces.<domain> → bounce.emailsbit.com) sudah dipublikasikan. Bounce dan keselarasan SPF bergantung padanya.

  • description

    Catatan Anda sendiri tentang domain, atau null.

  • dkim_key_size

    2048 atau 1024. null jika domain belum memiliki key.

  • dkim_deprecated

    true untuk key 1024-bit. Beberapa provider sudah menganggapnya lemah: lakukan upgrade dengan Start DKIM Upgrade.

  • dkim_upgrade_pending

    true selama key 2048-bit baru menunggu record DNS-nya.

  • created_at / updated_at

    ISO 8601, UTC.

  • registrar

    Lokasi hosting DNS, berdasarkan nameserver-nya: cloudflare, namecheap, godaddy, route53, google, vercel, hostinger, ionos, hetzner, dreamhost, squarespace, registrobr, atau other.

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

    Record yang perlu dipublikasikan. Masing-masing memiliki type, host, dan value. Lihat Record DNS di bawah.

  • dns_records.dkim_pending

    Hanya selama upgrade DKIM: record 2048-bit yang baru. Publikasikan di samping yang saat ini.

  • dns_records.*.split_value

    Hanya untuk nilai TXT lebih dari 255 karakter: nilai yang sama sudah dipecah menjadi string berkutip, untuk panel DNS yang memerlukannya.

  • dns_records.mx.priority

    Selalu 0.

  • spf_duplicate

    true jika domain memiliki lebih dari satu record SPF. Itu tidak valid: SPF gagal di semua penerima sampai Anda menggabungkannya menjadi satu.

  • spf_duplicate_records

    Record SPF yang ditemukan, untuk membantu Anda menggabungkannya.

  • dkim

    Key DKIM yang digunakan dan upgrade yang sedang berjalan. Lihat DKIM di bawah.

  • dkim.version

    2 untuk key 2048-bit, 1 untuk 1024.

  • dkim.key_size

    Ukuran key yang saat ini menandatangani email Anda.

  • dkim.selector

    Selector key yang digunakan: s= di header DKIM-Signature.

  • dkim.deprecated

    true untuk key 1024-bit.

  • dkim.upgrade_pending

    true selama key baru menunggu record DNS-nya.

  • dkim.pending

    Key baru: selector, key_size, host, full_host, value, split_value, created_at. null jika tidak ada upgrade.

  • dkim.previous_selector

    Selama 48 jam setelah upgrade: selector lama. Pertahankan record-nya hingga keep_old_record_until, lalu Anda bisa menghapusnya.

  • dkim.keep_old_record_until

    Kapan record lama boleh dihapus. null jika tidak ada yang perlu dihapus.

  • dkim.just_upgraded

    true hanya pada panggilan yang beralih ke key baru.

Setelah membatalkan

  • Record yang tertunda

    Jika Anda sudah memublikasikan record sendcorex2, Anda bisa menghapusnya.

  • Memulai lagi

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

  • 401INVALID_API_KEY

    API key tidak ada, sudah dicabut, atau dinonaktifkan di dashboard.

  • 429RATE_LIMITED

    Lebih dari 15 request/detik atau 15 bersamaan untuk IP + API key yang sama. Tunggu sesuai jumlah detik di Retry-After.

  • CMDMISSING_SCOPE

    API key tidak memiliki scope yang dibutuhkan perintah ini.

  • CMDINVALID_ARGS

    Ada argumen yang tidak valid: `domain` tidak ada atau salah format, `key_size` selain 1024/2048, `email` tidak valid, deskripsi lebih dari 255 karakter…

  • CMDDOMAIN_NOT_FOUND

    Domain tidak ada di akun Anda.

  • CMDDKIM_NOT_FOUND

    Domain tidak memiliki key DKIM.

  • CMDNO_PENDING_UPGRADE

    Tidak ada upgrade yang bisa dibatalkan.

  • CMDRATE_LIMITED

    Perintah ini dipanggil terlalu sering oleh akun Anda dalam satu menit terakhir. Tunggu satu menit.

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.