Email Validator: Rute

Run Commands

Titik masuk untuk validasi email. Kirim satu perintah per request: validasi satu alamat, hingga 50, atau baca riwayat Anda.

POSThttps://g.sendcorex.com/v1/tool/validate
i

Envelope-nya sama dengan Logs dan Contacts, tetapi tepat 1 perintah per request: validasi berkomunikasi dengan server email sungguhan dan bisa memakan waktu beberapa detik.

i

Error dilaporkan di hasil perintah, dan status HTTP tetap 200.

Parameter body

  • commandsobject[]wajib

    Tepat 1 perintah.

  • commands[].commandstringwajib

    validate_email, validate_emails, atau list_validations.

  • commands[].argsobjectopsional

    Argumen perintah.

  • commands[].idstringopsional

    Pengenal 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

  • type

    Selalu SUCCESS jika request itu sendiri diterima.

  • results[0].command / id / type

    Perintahnya, id Anda, dan SUCCESS atau ERROR.

  • results[0].took_ms

    Berapa lama validasi berlangsung. Sebagian besar alamat butuh 1 hingga 5 detik.

  • results[0].data

    Output perintah. Hanya ada jika type bernilai SUCCESS.

  • results[0].code / message

    Error-nya. Hanya ada jika type bernilai ERROR.

Autentikasi

Gunakan API key yang Anda buat di dashboard, di Developers → API Keys, dengan scope tools:validate.

  • Authorization

    Kirim Authorization: <api key> atau Authorization: Bearer <api key>.

  • tools:validate

    Dibutuhkan oleh setiap perintah di rute ini.

  • Token mailbox

    Token webmail tidak berfungsi di sini. Token itu ditolak dengan WRONG_CREDENTIAL_TYPE.

Kredit

  • 1 kredit per alamat

    Setiap alamat yang Anda validasi memakai satu kredit validasi. Alamat yang sama dua kali dalam satu perintah dihitung sekali.

  • Semua atau tidak sama sekali

    Jika kredit Anda tidak cukup untuk seluruh perintah, tidak ada yang divalidasi dan tidak ada biaya (INSUFFICIENT_CREDITS).

  • Pengembalian saat gagal

    Jika server validasi gagal, kredit untuk perintah itu dikembalikan (VALIDATION_FAILED).

  • Riwayat gratis

    list_validations membaca 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.

  • 400INVALID_JSON

    Body bukan {"commands":[...]} atau lebih besar dari 1 MB.

  • 400INVALID_ARGS

    Request tidak memiliki perintah atau lebih dari satu. Rute ini menerima tepat 1 perintah per request.

  • 401MISSING_AUTH_HEADER

    Tidak ada header Authorization yang dikirim.

  • 401INVALID_API_KEY

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

  • 401API_KEY_EXPIRED

    API key telah melewati tanggal kedaluwarsa yang diatur di dashboard.

  • 401WRONG_CREDENTIAL_TYPE

    Yang dikirim adalah token mailbox. Validasi email membutuhkan API key dari dashboard.

  • 403IP_NOT_ALLOWED

    Request berasal dari IP yang tidak termasuk IP yang diizinkan untuk key ini.

  • 403ACCOUNT_BLOCKED

    Akun diblokir.

  • 403MISSING_SCOPE

    Key tidak memiliki `tools:validate`, jadi tidak ada perintah yang bisa dijalankan.

  • 429RATE_LIMITED

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

  • 503AUTH_UNAVAILABLE

    Autentikasi sementara tidak tersedia. Coba lagi.

  • CMDUNKNOWN_COMMAND

    Nama perintah tidak ada.

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.