Email Validator: Validierung

E-Mails validieren

Validieren Sie bis zu 50 Adressen in einem Befehl. Sie werden parallel geprüft und kommen in der Reihenfolge zurück, in der Sie sie gesendet haben.

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

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

i

1 Credit pro eindeutiger Adresse. Doppelte Adressen werden einmal validiert und belastet und erscheinen einmal in results.

!

Wenn Ihre Credits nicht für die ganze Liste reichen, wird nichts validiert: Sie erhalten INSUFFICIENT_CREDITS mit der benötigten und der verfügbaren Anzahl.

Argumente

  • emailsstring[]erforderlich

    1 bis 50 Adressen.

    z. B. ["ana@acme.com", "jhon@gmial.com"]

Schnellstart

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

Antwort

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

Antwortfelder

  • results

    Ein Ergebnis pro eindeutiger Adresse, in der Reihenfolge, in der Sie sie gesendet haben.

  • count / valid_count / invalid_count

    Wie viele geprüft wurden und wie viele gültig bzw. ungültig zurückkamen.

  • credits_used

    Von diesem Befehl verbrauchte Credits.

  • results[].email

    Die Adresse, ohne Leerzeichen und in Kleinbuchstaben.

  • results[].valid

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

  • results[].checks[].check

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

  • results[].checks[].status

    Passed oder Failed.

  • results[].checks[].details

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

  • results[].checks[].fullResponse

    Nur bei Email Deliverability: die genaue Antwort des Postfachservers.

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

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

Große Listen

Für Tausende von Adressen rufen Sie diesen Befehl in Paketen zu 50 nacheinander auf, oder laden Sie die Datei im Dashboard hoch (Email Validator → Lists): Sie wird im Hintergrund validiert und Sie erhalten eine E-Mail mit der CSV, sobald sie fertig ist.

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.