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.
https://g.sendcorex.com/v1/tool/validatecommand: validate_emailsErfordert den Scope tools:validate für Ihren API key.
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[]erforderlich1 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
resultsEin Ergebnis pro eindeutiger Adresse, in der Reihenfolge, in der Sie sie gesendet haben.
count / valid_count / invalid_countWie viele geprüft wurden und wie viele gültig bzw. ungültig zurückkamen.
credits_usedVon diesem Befehl verbrauchte Credits.
results[].emailDie Adresse, ohne Leerzeichen und in Kleinbuchstaben.
results[].validtruenur, wenn jede Prüfung bestanden wurde.Provider TypeundEmail Provider Detectionsind informativ und machen es niefalse.results[].checks[].checkDer Name der Prüfung. Siehe Prüfungen unten.
results[].checks[].statusPassedoderFailed.results[].checks[].detailsEin Satz, der das Ergebnis erklärt, bereit, einem Nutzer angezeigt zu werden.
results[].checks[].fullResponseNur bei
Email Deliverability: die genaue Antwort des Postfachservers.results[].checks[].providerId / providerNameNur 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.
- 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.