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.
https://g.sendcorex.com/v1/tool/validatecommand: validate_emailErfordert den Scope tools:validate für Ihren API key.
Verbraucht 1 Validierungs-Credit.
Argumente
emailstringerforderlichDie 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
emailDie Adresse, ohne Leerzeichen und in Kleinbuchstaben.
validtruenur, wenn jede Prüfung bestanden wurde.Provider TypeundEmail Provider Detectionsind informativ und machen es niefalse.checks[].checkDer Name der Prüfung. Siehe Prüfungen unten.
checks[].statusPassedoderFailed.checks[].detailsEin Satz, der das Ergebnis erklärt, bereit, einem Nutzer angezeigt zu werden.
checks[].fullResponseNur bei
Email Deliverability: die genaue Antwort des Postfachservers.checks[].providerId / providerNameNur 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 ValidationDie Adresse hat ein gültiges Format. Schlägt das fehl, läuft nichts weiter.
Local Part ValidationDer Teil vor dem
@entspricht RFC 5322 (Länge, Punkte, Zeichen).Role-based Email CheckInformativ: zeigt an, ob es eine Team-Adresse wie
info@oderadmin@ist. Schlägt nie fehl.No-reply Email CheckSchlägt bei
noreply@und ähnlichen Adressen fehl, die nicht lesen, was sie erhalten.Temporary Email CheckSchlägt bei Wegwerf- und temporären Anbietern fehl.
Misspelled Domain CheckSchlägt bei häufigen Tippfehlern großer Anbieter fehl (
gmial.com,hotmial.com…) und schlägt die richtige Domain vor.Spam Trap CheckSchlägt bei Domains fehl, die als Spam Traps bekannt sind.
Provider TypeInformativ: kostenloser/privater Anbieter oder Firmendomain.
Domain ValidationDie Domain existiert und hat MX-Einträge.
Null MX CheckSchlägt fehl, wenn die Domain angibt, keine E-Mails anzunehmen (RFC 7505).
Email Provider DetectionInformativ: der Postfachanbieter, sofern bekannt.
Email DeliverabilityWir 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 CheckNur 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 blockierenWenn
validfalseist, zeigen Sie dem Nutzer diedetailsder ersten fehlgeschlagenen Prüfung.Die Korrektur vorschlagenMisspelled Domain Checkliefert die korrigierte Adresse indetails: Bieten Sie sie mit einem Klick an.Catch-allEine 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.
- 401
INVALID_API_KEYDer API key existiert nicht, wurde widerrufen oder im Dashboard deaktiviert.
- 429
RATE_LIMITEDMehr als 75 Requests/s oder 75 gleichzeitig für dieselbe IP + API key. Warten Sie die Anzahl Sekunden aus Retry-After ab.
- CMD
MISSING_SCOPEDer API key hat `tools:validate` nicht.
- CMD
INVALID_ARGSEin 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…
- CMD
INSUFFICIENT_CREDITSSie 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.
- CMD
CREDITS_UNAVAILABLEIhre Credits konnten gerade nicht gelesen werden. Nichts wurde belastet. Versuchen Sie es erneut.
- CMD
NO_SERVERS_AVAILABLEGerade ist kein Validierungsserver verfügbar. Nichts wurde belastet. Versuchen Sie es in Kürze erneut.
- CMD
VALIDATION_FAILEDDie Validierungsserver haben nicht rechtzeitig geantwortet. Ihre Credits wurden zurückerstattet. Versuchen Sie es erneut.
- CMD
INTERNALServerfehler. Details werden nur ins Server-Log geschrieben.