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.

POSThttps://g.sendcorex.com/v1/tool/validatecommand: validate_email
i

Membutuhkan scope tools:validate pada API key Anda.

i

Memakai 1 kredit validasi.

Argumen

  • emailstringwajib

    Alamat 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

  • email

    Alamatnya, tanpa spasi dan dalam huruf kecil.

  • valid

    true hanya jika semua pemeriksaan lolos. Provider Type dan Email Provider Detection bersifat informatif dan tidak pernah membuatnya false.

  • checks[].check

    Nama pemeriksaan. Lihat Pemeriksaan di bawah.

  • checks[].status

    Passed atau Failed.

  • checks[].details

    Kalimat yang menjelaskan hasilnya, siap ditampilkan ke pengguna.

  • checks[].fullResponse

    Hanya pada Email Deliverability: jawaban persis server kotak surat.

  • checks[].providerId / providerName

    Hanya 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 Validation

    Alamat memiliki format yang valid. Jika gagal, tidak ada pemeriksaan lain yang dijalankan.

  • Local Part Validation

    Bagian sebelum @ mengikuti RFC 5322 (panjang, titik, karakter).

  • Role-based Email Check

    Informatif: memberi tahu apakah ini alamat tim seperti info@ atau admin@. Tidak pernah gagal.

  • No-reply Email Check

    Gagal untuk noreply@ dan alamat serupa, yang tidak membaca email yang diterima.

  • Temporary Email Check

    Gagal untuk penyedia sekali pakai dan sementara.

  • Misspelled Domain Check

    Gagal untuk salah ketik umum pada penyedia besar (gmial.com, hotmial.com…) dan menyarankan yang benar.

  • Spam Trap Check

    Gagal untuk domain yang dikenal sebagai spam trap.

  • Provider Type

    Informatif: penyedia gratis/pribadi atau domain perusahaan.

  • Domain Validation

    Domain ada dan memiliki record MX.

  • Null MX Check

    Gagal jika domain menyatakan tidak menerima email (RFC 7505).

  • Email Provider Detection

    Informatif: penyedia kotak surat, jika kami mengetahuinya.

  • Email Deliverability

    Kami menanyakan ke server kotak surat apakah alamatnya ada, tanpa mengirim apa pun. Hanya dijalankan jika semua pemeriksaan di atas lolos.

  • Catch-all Mail Exchanger Check

    Hanya untuk domain perusahaan. Gagal jika server menerima alamat apa pun, sehingga kotak surat tidak bisa dikonfirmasi.

Memakai hasilnya

  • Blokir pendaftaran

    Jika valid bernilai false, tampilkan details dari pemeriksaan pertama yang gagal kepada pengguna.

  • Sarankan perbaikan

    Misspelled Domain Check menyertakan alamat yang sudah dikoreksi di details: tawarkan dengan satu klik.

  • Catch-all

    Pemeriksaan 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.

  • 401INVALID_API_KEY

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

  • 429RATE_LIMITED

    Lebih dari 75 request/dtk atau 75 bersamaan untuk IP + API key yang sama. Tunggu sejumlah detik yang ada di Retry-After.

  • CMDMISSING_SCOPE

    API key tidak memiliki `tools:validate`.

  • CMDINVALID_ARGS

    Ada 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…

  • CMDINSUFFICIENT_CREDITS

    Kredit Anda tidak cukup untuk seluruh perintah (kredit validasi untuk `validate_*`, kredit disposable untuk `check_disposable`). Tidak ada yang diperiksa dan tidak ada biaya.

  • CMDCREDITS_UNAVAILABLE

    Kredit Anda tidak bisa dibaca saat ini. Tidak ada biaya. Coba lagi.

  • CMDNO_SERVERS_AVAILABLE

    Tidak ada server validasi yang tersedia saat ini. Tidak ada biaya. Coba lagi sebentar lagi.

  • CMDVALIDATION_FAILED

    Server validasi tidak menjawab tepat waktu. Kredit Anda dikembalikan. Coba lagi.

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.