Email Validator: Routen

Run Commands

Der Einstiegspunkt für die E-Mail-Validierung. Senden Sie einen Befehl pro Request: eine Adresse validieren, bis zu 50, oder Ihren Verlauf lesen.

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

Derselbe Umschlag wie bei Logs und Contacts, aber mit genau 1 Befehl pro Request: Eine Validierung spricht mit echten Mailservern und kann einige Sekunden dauern.

i

Fehler werden im Ergebnis des Befehls gemeldet, und der HTTP-Status bleibt 200.

Body-Parameter

  • commandsobject[]erforderlich

    Genau 1 Befehl.

  • commands[].commandstringerforderlich

    validate_email, validate_emails oder list_validations.

  • commands[].argsobjectoptional

    Die Argumente des Befehls.

  • commands[].idstringoptional

    Ihr eigener Bezeichner für das Ergebnis. Standard: "0".

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

Antwortfelder

  • type

    Immer SUCCESS, wenn der Request selbst angenommen wurde.

  • results[0].command / id / type

    Der Befehl, Ihre ID und SUCCESS oder ERROR.

  • results[0].took_ms

    Wie lange die Validierung gedauert hat. Die meisten Adressen dauern 1 bis 5 Sekunden.

  • results[0].data

    Die Ausgabe des Befehls. Nur vorhanden, wenn type SUCCESS ist.

  • results[0].code / message

    Der Fehler. Nur vorhanden, wenn type ERROR ist.

Authentifizierung

Verwenden Sie den API key, den Sie im Dashboard unter Developers → API Keys erstellen, mit dem Scope tools:validate.

  • Authorization

    Senden Sie Authorization: <api key> oder Authorization: Bearer <api key>.

  • tools:validate

    Wird von jedem Befehl auf dieser Route benötigt.

  • Mailbox-Tokens

    Der Webmail-Token funktioniert hier nicht. Er wird mit WRONG_CREDENTIAL_TYPE abgelehnt.

Credits

  • 1 Credit pro Adresse

    Jede validierte Adresse verbraucht einen Validierungs-Credit. Dieselbe Adresse zweimal in einem Befehl zählt einmal.

  • Alles oder nichts

    Wenn Sie nicht genug Credits für den ganzen Befehl haben, wird nichts validiert und nichts belastet (INSUFFICIENT_CREDITS).

  • Erstattung bei Fehlern

    Wenn die Validierungsserver ausfallen, werden die Credits dieses Befehls zurückerstattet (VALIDATION_FAILED).

  • Der Verlauf ist kostenlos

    list_validations liest, was Sie bereits validiert haben, und kostet nichts.

Timeouts

Eine Validierung fragt den echten Mailserver ab und ist daher langsamer als die anderen APIs. Setzen Sie den Timeout Ihres HTTP-Clients für validate_emails auf mindestens 2 Minuten.

Fehler

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

  • 400INVALID_JSON

    Der Body ist nicht {"commands":[...]} oder größer als 1 MB.

  • 400INVALID_ARGS

    Der Request enthält keinen Befehl oder mehr als einen. Diese Route nimmt genau 1 Befehl pro Request.

  • 401MISSING_AUTH_HEADER

    Es wurde kein Authorization-Header gesendet.

  • 401INVALID_API_KEY

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

  • 401API_KEY_EXPIRED

    Der API key hat das im Dashboard festgelegte Ablaufdatum überschritten.

  • 401WRONG_CREDENTIAL_TYPE

    Es wurde ein Mailbox-Token gesendet. Die E-Mail-Validierung braucht einen API key aus dem Dashboard.

  • 403IP_NOT_ALLOWED

    Der Request kam von einer IP, die nicht zu den erlaubten IPs des Keys gehört.

  • 403ACCOUNT_BLOCKED

    Das Konto ist gesperrt.

  • 403MISSING_SCOPE

    Der Key hat `tools:validate` nicht, daher kann kein Befehl ausgeführt werden.

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

  • 503AUTH_UNAVAILABLE

    Die Authentifizierung ist vorübergehend nicht verfügbar. Versuchen Sie es erneut.

  • CMDUNKNOWN_COMMAND

    Der Befehlsname existiert nicht.

  • CMDINTERNAL

    Serverfehler. Details werden nur ins Server-Log geschrieben.