Email Validator: Validasi
Validasi banyak email
Validasi hingga 50 alamat dalam satu perintah. Alamat diperiksa secara paralel dan dikembalikan sesuai urutan yang Anda kirim.
https://g.sendcorex.com/v1/tool/validatecommand: validate_emailsMembutuhkan scope tools:validate pada API key Anda.
1 kredit per alamat unik. Alamat yang berulang divalidasi dan dikenai biaya sekali, dan muncul sekali di results.
Jika kredit Anda tidak mencukupi seluruh daftar, tidak ada yang divalidasi: Anda menerima INSUFFICIENT_CREDITS beserta jumlah yang dibutuhkan dan yang Anda miliki.
Argumen
emailsstring[]wajib1 hingga 50 alamat.
mis.
["ana@acme.com", "jhon@gmial.com"]
Mulai cepat
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/tool/validate',
{
commands: [
{
command: "validate_emails",
args: {
emails: [
"ana@acme.com",
"jhon@gmial.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": "validate_emails",
"id": "0",
"type": "SUCCESS",
"took_ms": 18,
"data": {
"results": [
{
"email": "ana@acme.com",
"valid": true,
"checks": [
{
"check": "Format Validation",
"status": "Passed",
"details": "Valid email format"
},
{
"check": "Local Part Validation",
"status": "Passed",
"details": "Local part is RFC compliant"
},
{
"check": "Role-based Email Check",
"status": "Passed",
"details": "Not a role-based address"
},
{
"check": "No-reply Email Check",
"status": "Passed",
"details": "Not a no-reply address"
},
{
"check": "Temporary Email Check",
"status": "Passed",
"details": "Not a temporary email"
},
{
"check": "Misspelled Domain Check",
"status": "Passed",
"details": "Correct"
},
{
"check": "Spam Trap Check",
"status": "Passed",
"details": "Not a spam trap"
},
{
"check": "Provider Type",
"status": "Passed",
"details": "Corporate or custom domain"
},
{
"check": "Domain Validation",
"status": "Passed",
"details": "Domain is valid and has MX records"
},
{
"check": "Null MX Check",
"status": "Passed",
"details": "Domain accepts email"
},
{
"check": "Email Provider Detection",
"status": "Passed",
"details": "Domain is hosted on a known provider: Google Workspace",
"providerId": 1,
"providerName": "Google Workspace"
},
{
"check": "Email Deliverability",
"status": "Passed",
"details": "Mailbox exists",
"fullResponse": "250 2.1.5 OK"
},
{
"check": "Catch-all Mail Exchanger Check",
"status": "Passed",
"details": "Mail exchanger correctly rejects nonexistent addresses"
}
]
},
{
"email": "jhon@gmial.com",
"valid": false,
"checks": [
{
"check": "Format Validation",
"status": "Passed",
"details": "Valid email format"
},
{
"check": "Local Part Validation",
"status": "Passed",
"details": "Local part is RFC compliant"
},
{
"check": "Role-based Email Check",
"status": "Passed",
"details": "Not a role-based address"
},
{
"check": "No-reply Email Check",
"status": "Passed",
"details": "Not a no-reply address"
},
{
"check": "Temporary Email Check",
"status": "Passed",
"details": "Not a temporary email"
},
{
"check": "Misspelled Domain Check",
"status": "Failed",
"details": "Possible typo. Suggested correction: jhon@gmail.com"
},
{
"check": "Spam Trap Check",
"status": "Passed",
"details": "Not a spam trap"
},
{
"check": "Provider Type",
"status": "Passed",
"details": "Corporate or custom domain"
},
{
"check": "Domain Validation",
"status": "Failed",
"details": "Invalid domain or no MX records"
}
]
}
],
"count": 2,
"valid_count": 1,
"invalid_count": 1,
"credits_used": 2
}
}
]
}Field respons
resultsSatu hasil per alamat unik, sesuai urutan yang Anda kirim.
count / valid_count / invalid_countBerapa yang diperiksa, dan berapa yang valid dan tidak valid.
credits_usedKredit yang dipakai perintah ini.
results[].emailAlamatnya, tanpa spasi dan dalam huruf kecil.
results[].validtruehanya jika semua pemeriksaan lolos.Provider TypedanEmail Provider Detectionbersifat informatif dan tidak pernah membuatnyafalse.results[].checks[].checkNama pemeriksaan. Lihat Pemeriksaan di bawah.
results[].checks[].statusPassedatauFailed.results[].checks[].detailsKalimat yang menjelaskan hasilnya, siap ditampilkan ke pengguna.
results[].checks[].fullResponseHanya pada
Email Deliverability: jawaban persis server kotak surat.results[].checks[].providerId / providerNameHanya pada
Email Provider Detection: penyedia email yang meng-host domain tersebut.
Daftar besar
Untuk ribuan alamat, panggil perintah ini dalam potongan 50, satu per satu, atau unggah file di dashboard (Email Validator → Lists): file divalidasi di latar belakang dan Anda menerima email berisi CSV setelah selesai.
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, telah dicabut, atau dinonaktifkan di dashboard.
- 429
RATE_LIMITEDLebih dari 75 request/dtk atau 75 bersamaan untuk IP + API key yang sama. Tunggu sejumlah detik yang ada di Retry-After.
- CMD
MISSING_SCOPEAPI key tidak memiliki `tools:validate`.
- CMD
INVALID_ARGSAda argumen yang tidak valid: email tidak ada (atau domain, untuk `check_disposable`), lebih dari 50 email, alamat lebih dari 254 karakter, limit di luar rentang…
- CMD
INSUFFICIENT_CREDITSKredit Anda tidak cukup untuk seluruh perintah (kredit validasi untuk `validate_*`, kredit disposable untuk `check_disposable`). Tidak ada yang diperiksa dan tidak ada biaya.
- CMD
CREDITS_UNAVAILABLEKredit Anda tidak bisa dibaca saat ini. Tidak ada biaya. Coba lagi.
- CMD
NO_SERVERS_AVAILABLETidak ada server validasi yang tersedia saat ini. Tidak ada biaya. Coba lagi sebentar lagi.
- CMD
VALIDATION_FAILEDServer validasi tidak menjawab tepat waktu. Kredit Anda dikembalikan. Coba lagi.
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.