Email Validator: Rute
Run Commands
Titik masuk untuk validasi email. Kirim satu perintah per request: validasi satu alamat, hingga 50, atau baca riwayat Anda.
https://g.sendcorex.com/v1/tool/validateEnvelope-nya sama dengan Logs dan Contacts, tetapi tepat 1 perintah per request: validasi berkomunikasi dengan server email sungguhan dan bisa memakan waktu beberapa detik.
Error dilaporkan di hasil perintah, dan status HTTP tetap 200.
Parameter body
commandsobject[]wajibTepat 1 perintah.
commands[].commandstringwajibvalidate_email,validate_emails, ataulist_validations.commands[].argsobjectopsionalArgumen perintah.
commands[].idstringopsionalPengenal Anda sendiri untuk hasilnya. Default-nya
"0".
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": 1840,
"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
typeSelalu
SUCCESSjika request itu sendiri diterima.results[0].command / id / typePerintahnya, id Anda, dan
SUCCESSatauERROR.results[0].took_msBerapa lama validasi berlangsung. Sebagian besar alamat butuh 1 hingga 5 detik.
results[0].dataOutput perintah. Hanya ada jika
typebernilaiSUCCESS.results[0].code / messageError-nya. Hanya ada jika
typebernilaiERROR.
Autentikasi
Gunakan API key yang Anda buat di dashboard, di Developers → API Keys, dengan scope tools:validate.
AuthorizationKirim
Authorization: <api key>atauAuthorization: Bearer <api key>.tools:validateDibutuhkan oleh setiap perintah di rute ini.
Token mailboxToken webmail tidak berfungsi di sini. Token itu ditolak dengan
WRONG_CREDENTIAL_TYPE.
Kredit
1 kredit per alamatSetiap alamat yang Anda validasi memakai satu kredit validasi. Alamat yang sama dua kali dalam satu perintah dihitung sekali.
Semua atau tidak sama sekaliJika kredit Anda tidak cukup untuk seluruh perintah, tidak ada yang divalidasi dan tidak ada biaya (
INSUFFICIENT_CREDITS).Pengembalian saat gagalJika server validasi gagal, kredit untuk perintah itu dikembalikan (
VALIDATION_FAILED).Riwayat gratislist_validationsmembaca apa yang sudah Anda validasi dan tidak dikenai biaya.
Timeout
Validasi menanyakan ke server email sungguhan, jadi lebih lambat dari API lainnya. Atur timeout klien HTTP Anda minimal 2 menit untuk validate_emails.
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 satu. Rute ini menerima tepat 1 perintah per request.
- 401
MISSING_AUTH_HEADERTidak ada header Authorization yang dikirim.
- 401
INVALID_API_KEYAPI key tidak ada, telah dicabut, atau dinonaktifkan di dashboard.
- 401
API_KEY_EXPIREDAPI key telah melewati tanggal kedaluwarsa yang diatur di dashboard.
- 401
WRONG_CREDENTIAL_TYPEYang dikirim adalah token mailbox. Validasi email membutuhkan API key dari dashboard.
- 403
IP_NOT_ALLOWEDRequest berasal dari IP yang tidak termasuk IP yang diizinkan untuk key ini.
- 403
ACCOUNT_BLOCKEDAkun diblokir.
- 403
MISSING_SCOPEKey tidak memiliki `tools:validate`, jadi tidak ada perintah yang bisa dijalankan.
- 429
RATE_LIMITEDLebih dari 75 request/dtk atau 75 bersamaan untuk IP + API key yang sama. Tunggu sejumlah detik yang ada 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.