Email Validator: Validasi
Validasi email
Periksa alamat sebelum mengirim ke sana: format, domain, MX, penyedia sementara, salah ketik, spam trap, dan apakah kotak suratnya benar-benar ada.
https://g.sendcorex.com/v1/tool/validatecommand: validate_emailMembutuhkan scope tools:validate pada API key Anda.
Memakai 1 kredit validasi.
Argumen
emailstringwajibAlamat yang akan diperiksa. Hingga 254 karakter.
mis.
"ana@acme.com"
Mulai cepat
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/tool/validate',
{
commands: [
{
command: "validate_email",
args: {
email: "ana@acme.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_email",
"id": "0",
"type": "SUCCESS",
"took_ms": 18,
"data": {
"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"
}
]
}
}
]
}Field respons
emailAlamatnya, tanpa spasi dan dalam huruf kecil.
validtruehanya jika semua pemeriksaan lolos.Provider TypedanEmail Provider Detectionbersifat informatif dan tidak pernah membuatnyafalse.checks[].checkNama pemeriksaan. Lihat Pemeriksaan di bawah.
checks[].statusPassedatauFailed.checks[].detailsKalimat yang menjelaskan hasilnya, siap ditampilkan ke pengguna.
checks[].fullResponseHanya pada
Email Deliverability: jawaban persis server kotak surat.checks[].providerId / providerNameHanya pada
Email Provider Detection: penyedia email yang meng-host domain tersebut.
Pemeriksaan
Dijalankan dalam urutan ini dan berhenti lebih awal jika tidak ada gunanya dilanjutkan (tanpa MX, format salah…).
Format ValidationAlamat memiliki format yang valid. Jika gagal, tidak ada pemeriksaan lain yang dijalankan.
Local Part ValidationBagian sebelum
@mengikuti RFC 5322 (panjang, titik, karakter).Role-based Email CheckInformatif: memberi tahu apakah ini alamat tim seperti
info@atauadmin@. Tidak pernah gagal.No-reply Email CheckGagal untuk
noreply@dan alamat serupa, yang tidak membaca email yang diterima.Temporary Email CheckGagal untuk penyedia sekali pakai dan sementara.
Misspelled Domain CheckGagal untuk salah ketik umum pada penyedia besar (
gmial.com,hotmial.com…) dan menyarankan yang benar.Spam Trap CheckGagal untuk domain yang dikenal sebagai spam trap.
Provider TypeInformatif: penyedia gratis/pribadi atau domain perusahaan.
Domain ValidationDomain ada dan memiliki record MX.
Null MX CheckGagal jika domain menyatakan tidak menerima email (RFC 7505).
Email Provider DetectionInformatif: penyedia kotak surat, jika kami mengetahuinya.
Email DeliverabilityKami menanyakan ke server kotak surat apakah alamatnya ada, tanpa mengirim apa pun. Hanya dijalankan jika semua pemeriksaan di atas lolos.
Catch-all Mail Exchanger CheckHanya untuk domain perusahaan. Gagal jika server menerima alamat apa pun, sehingga kotak surat tidak bisa dikonfirmasi.
Memakai hasilnya
Blokir pendaftaranJika
validbernilaifalse, tampilkandetailsdari pemeriksaan pertama yang gagal kepada pengguna.Sarankan perbaikanMisspelled Domain Checkmenyertakan alamat yang sudah dikoreksi didetails: tawarkan dengan satu klik.Catch-allPemeriksaan catch-all yang gagal berarti server menerima apa pun. Alamatnya mungkin ada, tetapi tidak ada yang bisa membuktikannya sebelum mengirim.
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.