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.

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

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

  • 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: "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

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

Cara kerja upgrade

Email Anda ditandatangani dengan key lama sepanjang waktu, sampai key baru ada di DNS.

  • 1. Mulai

    Perintah ini. Key baru masuk ke dkim.pending dan dns_records.dkim_pending (selector sendcorex2).

  • 2. Publikasikan

    Buat record TXT dkim_pending. Pertahankan yang lama.

  • 3. Periksa

    Panggil Get Domain. Begitu record baru ditemukan, key baru mulai menandatangani (dkim.just_upgraded bernilai true pada panggilan itu).

  • 4. Bersihkan

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

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

  • CMDALREADY_UPGRADED

    Domain sudah menggunakan key 2048-bit.

  • CMDDKIM_GENERATION_FAILED

    Key DKIM tidak dapat dibuat. Tidak ada yang disimpan. Coba lagi.

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