Email Validator: Validierung

E-Mail validieren

Prüfen Sie eine Adresse, bevor Sie an sie senden: Format, Domain, MX, temporäre Anbieter, Tippfehler, Spam Traps und ob das Postfach wirklich existiert.

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

Erfordert den Scope tools:validate für Ihren API key.

i

Verbraucht 1 Validierungs-Credit.

Argumente

  • emailstringerforderlich

    Die zu prüfende Adresse. Bis zu 254 Zeichen.

    z. B. "ana@acme.com"

Schnellstart

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);

Antwort

{
  "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"
          }
        ]
      }
    }
  ]
}

Antwortfelder

  • email

    Die Adresse, ohne Leerzeichen und in Kleinbuchstaben.

  • valid

    true nur, wenn jede Prüfung bestanden wurde. Provider Type und Email Provider Detection sind informativ und machen es nie false.

  • checks[].check

    Der Name der Prüfung. Siehe Prüfungen unten.

  • checks[].status

    Passed oder Failed.

  • checks[].details

    Ein Satz, der das Ergebnis erklärt, bereit, einem Nutzer angezeigt zu werden.

  • checks[].fullResponse

    Nur bei Email Deliverability: die genaue Antwort des Postfachservers.

  • checks[].providerId / providerName

    Nur bei Email Provider Detection: der Mail-Anbieter, der die Domain hostet.

Prüfungen

Sie laufen in dieser Reihenfolge und brechen früh ab, wenn Weitermachen keinen Sinn ergibt (kein MX, falsches Format…).

  • Format Validation

    Die Adresse hat ein gültiges Format. Schlägt das fehl, läuft nichts weiter.

  • Local Part Validation

    Der Teil vor dem @ entspricht RFC 5322 (Länge, Punkte, Zeichen).

  • Role-based Email Check

    Informativ: zeigt an, ob es eine Team-Adresse wie info@ oder admin@ ist. Schlägt nie fehl.

  • No-reply Email Check

    Schlägt bei noreply@ und ähnlichen Adressen fehl, die nicht lesen, was sie erhalten.

  • Temporary Email Check

    Schlägt bei Wegwerf- und temporären Anbietern fehl.

  • Misspelled Domain Check

    Schlägt bei häufigen Tippfehlern großer Anbieter fehl (gmial.com, hotmial.com…) und schlägt die richtige Domain vor.

  • Spam Trap Check

    Schlägt bei Domains fehl, die als Spam Traps bekannt sind.

  • Provider Type

    Informativ: kostenloser/privater Anbieter oder Firmendomain.

  • Domain Validation

    Die Domain existiert und hat MX-Einträge.

  • Null MX Check

    Schlägt fehl, wenn die Domain angibt, keine E-Mails anzunehmen (RFC 7505).

  • Email Provider Detection

    Informativ: der Postfachanbieter, sofern bekannt.

  • Email Deliverability

    Wir fragen den Postfachserver, ob die Adresse existiert, ohne etwas zu senden. Läuft nur, wenn alle Prüfungen oben bestanden wurden.

  • Catch-all Mail Exchanger Check

    Nur für Firmendomains. Schlägt fehl, wenn der Server jede Adresse annimmt, sodass das Postfach nicht bestätigt werden kann.

Das Ergebnis nutzen

  • Die Anmeldung blockieren

    Wenn valid false ist, zeigen Sie dem Nutzer die details der ersten fehlgeschlagenen Prüfung.

  • Die Korrektur vorschlagen

    Misspelled Domain Check liefert die korrigierte Adresse in details: Bieten Sie sie mit einem Klick an.

  • Catch-all

    Eine fehlgeschlagene Catch-all-Prüfung bedeutet, dass der Server alles annimmt. Die Adresse kann existieren, aber niemand kann es vor dem Senden beweisen.

Fehler

Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.

  • 401INVALID_API_KEY

    Der API key existiert nicht, wurde widerrufen oder im Dashboard deaktiviert.

  • 429RATE_LIMITED

    Mehr als 75 Requests/s oder 75 gleichzeitig für dieselbe IP + API key. Warten Sie die Anzahl Sekunden aus Retry-After ab.

  • CMDMISSING_SCOPE

    Der API key hat `tools:validate` nicht.

  • CMDINVALID_ARGS

    Ein Argument ist ungültig: fehlende E-Mail (oder Domain bei `check_disposable`), mehr als 50 E-Mails, eine Adresse über 254 Zeichen, limit außerhalb des Bereichs…

  • CMDINSUFFICIENT_CREDITS

    Sie haben nicht genug Credits für den ganzen Befehl (Validierungs-Credits für `validate_*`, Disposable-Credits für `check_disposable`). Nichts wurde geprüft und nichts belastet.

  • CMDCREDITS_UNAVAILABLE

    Ihre Credits konnten gerade nicht gelesen werden. Nichts wurde belastet. Versuchen Sie es erneut.

  • CMDNO_SERVERS_AVAILABLE

    Gerade ist kein Validierungsserver verfügbar. Nichts wurde belastet. Versuchen Sie es in Kürze erneut.

  • CMDVALIDATION_FAILED

    Die Validierungsserver haben nicht rechtzeitig geantwortet. Ihre Credits wurden zurückerstattet. Versuchen Sie es erneut.

  • CMDINTERNAL

    Serverfehler. Details werden nur ins Server-Log geschrieben.