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.
https://g.sendcorex.com/v1/domainEnvelope yang sama dengan Contacts, Logs, dan Bounces & Complaints. Halaman di bawah ini mendokumentasikan setiap perintah.
Error dilaporkan per perintah. Perintah yang gagal tidak menghentikan yang lain, dan status HTTP tetap 200.
Domain diidentifikasi dengan namanya (acme.com), tidak pernah dengan id internal.
Parameter body
commandsobject[]wajib1 sampai 10 perintah, dijalankan berurutan. Seluruh body bisa berukuran hingga 1 MB.
commands[].commandstringwajiblist_domains,get_domain,add_domain,delete_domain,update_domain_description,list_free_domains,start_dkim_upgrade,cancel_dkim_upgrade,send_dns_instructions, ataurequest_domain_remediation.commands[].argsobjectopsionalArgumen perintah. Nilai apa pun bisa berupa
$refke hasil perintah sebelumnya.commands[].idstringopsionalIdentifier 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
typeSelalu
SUCCESSjika request-nya sendiri diterima.results[].commandPerintah yang menghasilkan hasil ini.
results[].ididyang Anda kirim, atau indeks perintah.results[].typeSUCCESSatauERROR.results[].took_msWaktu yang dibutuhkan perintah di dalam server. Perintah yang memeriksa DNS butuh waktu lebih lama.
results[].dataOutput perintah. Hanya ada jika
typebernilaiSUCCESS.results[].code / messageError-nya. Hanya ada jika
typebernilaiERROR.
Autentikasi
Gunakan API key yang Anda buat di dashboard, di Developers → API Keys, dengan scope yang dibutuhkan perintah.
AuthorizationKirim
Authorization: <api key>atauAuthorization: Bearer <api key>.domain:readlist_domains,get_domain,list_free_domains, dansend_dns_instructions.domain:createadd_domain,start_dkim_upgrade,cancel_dkim_upgrade,update_domain_description, danrequest_domain_remediation.domain:deletedelete_domain. Berikan hanya ke key yang benar-benar membutuhkannya: menghapus domain juga menghapus sender-nya.Token mailboxToken webmail tidak berfungsi di sini. Token ditolak dengan
WRONG_CREDENTIAL_TYPE.IP yang diizinkanJika 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 / detikPer IP + API key. Jika melebihi, HTTP 429 dengan header
Retry-After.15 bersamaanMaksimal 15 request diproses pada saat yang sama, per IP + API key.
Per perintah, per akunadd_domain10/menit ·get_domain60/menit ·delete_domain30/menit ·start_dkim_upgradedancancel_dkim_upgrade10/menit ·update_domain_description20/menit ·send_dns_instructionsdanrequest_domain_remediation5/menit. Jika melebihi, perintah tersebut menjawabRATE_LIMITED.Tanpa cacheSetiap 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.
- 400
INVALID_JSONBody bukan {"commands":[...]} atau lebih besar dari 1 MB.
- 400
INVALID_ARGSRequest tidak memiliki perintah atau lebih dari 10.
- 401
MISSING_AUTH_HEADERTidak ada header Authorization yang dikirim.
- 401
INVALID_API_KEYAPI key tidak ada, sudah dicabut, atau dinonaktifkan di dashboard.
- 401
API_KEY_EXPIREDAPI key telah melewati tanggal kedaluwarsa yang diatur di dashboard.
- 401
WRONG_CREDENTIAL_TYPEToken mailbox yang dikirim. Domains API membutuhkan API key dari dashboard.
- 403
IP_NOT_ALLOWEDRequest berasal dari IP yang tidak ada dalam daftar IP yang diizinkan untuk key ini.
- 403
ACCOUNT_BLOCKEDAkun diblokir.
- 403
MISSING_SCOPEKey tidak memiliki scope `domain:*`, jadi tidak ada perintah yang bisa dijalankan.
- 429
RATE_LIMITEDLebih dari 15 request/detik atau 15 bersamaan untuk IP + API key yang sama. Tunggu sesuai jumlah detik di Retry-After.
- 503
AUTH_UNAVAILABLEAutentikasi sementara tidak tersedia. Coba lagi.
- CMD
UNKNOWN_COMMANDNama perintah tidak ada.
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.