Email Validator: Validasi

Validasi banyak email

Validasi hingga 50 alamat dalam satu perintah. Alamat diperiksa secara paralel dan dikembalikan sesuai urutan yang Anda kirim.

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

Membutuhkan scope tools:validate pada API key Anda.

i

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[]wajib

    1 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

  • results

    Satu hasil per alamat unik, sesuai urutan yang Anda kirim.

  • count / valid_count / invalid_count

    Berapa yang diperiksa, dan berapa yang valid dan tidak valid.

  • credits_used

    Kredit yang dipakai perintah ini.

  • results[].email

    Alamatnya, tanpa spasi dan dalam huruf kecil.

  • results[].valid

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

  • results[].checks[].check

    Nama pemeriksaan. Lihat Pemeriksaan di bawah.

  • results[].checks[].status

    Passed atau Failed.

  • results[].checks[].details

    Kalimat yang menjelaskan hasilnya, siap ditampilkan ke pengguna.

  • results[].checks[].fullResponse

    Hanya pada Email Deliverability: jawaban persis server kotak surat.

  • results[].checks[].providerId / providerName

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

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