Domain: route

Run Commands

Satu-satunya titik masuk untuk domain pengirim. Kirim 1 sampai 10 perintah dalam satu request dan dapatkan satu hasil per perintah.

POSThttps://g.sendcorex.com/v1/domain
i

Envelope yang sama dengan Contacts, Logs, dan Bounces & Complaints. Halaman di bawah ini mendokumentasikan setiap perintah.

i

Error dilaporkan per perintah. Perintah yang gagal tidak menghentikan yang lain, dan status HTTP tetap 200.

i

Domain diidentifikasi dengan namanya (acme.com), tidak pernah dengan id internal.

Parameter body

  • commandsobject[]wajib

    1 sampai 10 perintah, dijalankan berurutan. Seluruh body bisa berukuran hingga 1 MB.

  • commands[].commandstringwajib

    list_domains, get_domain, add_domain, delete_domain, update_domain_description, list_free_domains, start_dkim_upgrade, cancel_dkim_upgrade, send_dns_instructions, atau request_domain_remediation.

  • commands[].argsobjectopsional

    Argumen perintah. Nilai apa pun bisa berupa $ref ke hasil perintah sebelumnya.

  • commands[].idstringopsional

    Identifier Anda sendiri untuk hasilnya. Default-nya indeks ("0", "1"…). Wajib jika Anda ingin memakai $ref.

Mulai cepat

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/domain',
  {
    commands: [
      {
        command: "list_domains",
        id: "mine"
      },
      {
        command: "list_free_domains",
        id: "free"
      }
    ]
  },
  { headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);

for (const result of response.data.results) {
  if (result.type !== 'SUCCESS') console.error(result.id, result.code, result.message);
  else console.log(result.id, result.data);
}

Respons

{
  "type": "SUCCESS",
  "results": [
    {
      "command": "list_domains",
      "id": "mine",
      "type": "SUCCESS",
      "took_ms": 6,
      "data": {
        "domains": [
          {
            "domain": "acme.com",
            "validated": true,
            "has_mx": true,
            "has_spf": true,
            "has_dkim": true,
            "has_dmarc": true,
            "has_return_path": true,
            "description": "Transactional (app emails)",
            "dkim_key_size": 2048,
            "dkim_deprecated": false,
            "dkim_upgrade_pending": false,
            "created_at": "2026-09-02T14:21:07.118Z",
            "updated_at": "2026-10-21T02:40:51.902Z"
          }
        ]
      }
    },
    {
      "command": "list_free_domains",
      "id": "free",
      "type": "SUCCESS",
      "took_ms": 0,
      "data": {
        "domains": [
          "corexsend.com",
          "inboxtaken.com",
          "outsending.com",
          "shieldhaus.uk",
          "shieldhaus.info",
          "mailverifypro.info",
          "mailverifypro.online",
          "mailverifypro.store",
          "mailverifypro.org"
        ]
      }
    }
  ]
}

Field respons

  • type

    Selalu SUCCESS jika request-nya sendiri diterima.

  • results[].command

    Perintah yang menghasilkan hasil ini.

  • results[].id

    id yang Anda kirim, atau indeks perintah.

  • results[].type

    SUCCESS atau ERROR.

  • results[].took_ms

    Waktu yang dibutuhkan perintah di dalam server. Perintah yang memeriksa DNS butuh waktu lebih lama.

  • results[].data

    Output perintah. Hanya ada jika type bernilai SUCCESS.

  • results[].code / message

    Error-nya. Hanya ada jika type bernilai ERROR.

Autentikasi

Gunakan API key yang Anda buat di dashboard, di Developers → API Keys, dengan scope yang dibutuhkan perintah.

  • Authorization

    Kirim Authorization: <api key> atau Authorization: Bearer <api key>.

  • domain:read

    list_domains, get_domain, list_free_domains, dan send_dns_instructions.

  • domain:create

    add_domain, start_dkim_upgrade, cancel_dkim_upgrade, update_domain_description, dan request_domain_remediation.

  • domain:delete

    delete_domain. Berikan hanya ke key yang benar-benar membutuhkannya: menghapus domain juga menghapus sender-nya.

  • Token mailbox

    Token webmail tidak berfungsi di sini. Token ditolak dengan WRONG_CREDENTIAL_TYPE.

  • IP yang diizinkan

    Jika key memiliki allowlist IP, request dari IP lain mendapat 403 IP_NOT_ALLOWED.

Merangkai dengan $ref

Tambahkan domain dan baca kembali dalam satu request: perintah kedua mengambil domain dari hasil pertama.

add_domain → get_domain

{
  "commands": [
    {
      "command": "add_domain",
      "id": "new",
      "args": {
        "domain": "acme.com"
      }
    },
    {
      "command": "get_domain",
      "args": {
        "domain": {
          "$ref": "new",
          "path": "domain"
        }
      }
    }
  ]
}

Rate limit

Dua batas. Yang pertama untuk seluruh route, yang kedua untuk beberapa perintah.

  • 15 request / detik

    Per IP + API key. Jika melebihi, HTTP 429 dengan header Retry-After.

  • 15 bersamaan

    Maksimal 15 request diproses pada saat yang sama, per IP + API key.

  • Per perintah, per akun

    add_domain 10/menit · get_domain 60/menit · delete_domain 30/menit · start_dkim_upgrade dan cancel_dkim_upgrade 10/menit · update_domain_description 20/menit · send_dns_instructions dan request_domain_remediation 5/menit. Jika melebihi, perintah tersebut menjawab RATE_LIMITED.

  • Tanpa cache

    Setiap panggilan membaca database (dan DNS, untuk get_domain). Yang Anda dapatkan selalu terbaru.

Error

Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.

  • 400INVALID_JSON

    Body bukan {"commands":[...]} atau lebih besar dari 1 MB.

  • 400INVALID_ARGS

    Request tidak memiliki perintah atau lebih dari 10.

  • 401MISSING_AUTH_HEADER

    Tidak ada header Authorization yang dikirim.

  • 401INVALID_API_KEY

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

  • 401API_KEY_EXPIRED

    API key telah melewati tanggal kedaluwarsa yang diatur di dashboard.

  • 401WRONG_CREDENTIAL_TYPE

    Token mailbox yang dikirim. Domains API membutuhkan API key dari dashboard.

  • 403IP_NOT_ALLOWED

    Request berasal dari IP yang tidak ada dalam daftar IP yang diizinkan untuk key ini.

  • 403ACCOUNT_BLOCKED

    Akun diblokir.

  • 403MISSING_SCOPE

    Key tidak memiliki scope `domain:*`, jadi tidak ada perintah yang bisa dijalankan.

  • 429RATE_LIMITED

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

  • 503AUTH_UNAVAILABLE

    Autentikasi sementara tidak tersedia. Coba lagi.

  • CMDUNKNOWN_COMMAND

    Nama perintah tidak ada.

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.