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.
https://g.sendcorex.com/v1/tool/validateDerselbe Umschlag wie bei Logs und Contacts, aber mit genau 1 Befehl pro Request: Eine Validierung spricht mit echten Mailservern und kann einige Sekunden dauern.
Fehler werden im Ergebnis des Befehls gemeldet, und der HTTP-Status bleibt 200.
Body-Parameter
commandsobject[]erforderlichGenau 1 Befehl.
commands[].commandstringerforderlichvalidate_email,validate_emailsoderlist_validations.commands[].argsobjectoptionalDie Argumente des Befehls.
commands[].idstringoptionalIhr 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
typeImmer
SUCCESS, wenn der Request selbst angenommen wurde.results[0].command / id / typeDer Befehl, Ihre ID und
SUCCESSoderERROR.results[0].took_msWie lange die Validierung gedauert hat. Die meisten Adressen dauern 1 bis 5 Sekunden.
results[0].dataDie Ausgabe des Befehls. Nur vorhanden, wenn
typeSUCCESSist.results[0].code / messageDer Fehler. Nur vorhanden, wenn
typeERRORist.
Authentifizierung
Verwenden Sie den API key, den Sie im Dashboard unter Developers → API Keys erstellen, mit dem Scope tools:validate.
AuthorizationSenden Sie
Authorization: <api key>oderAuthorization: Bearer <api key>.tools:validateWird von jedem Befehl auf dieser Route benötigt.
Mailbox-TokensDer Webmail-Token funktioniert hier nicht. Er wird mit
WRONG_CREDENTIAL_TYPEabgelehnt.
Credits
1 Credit pro AdresseJede validierte Adresse verbraucht einen Validierungs-Credit. Dieselbe Adresse zweimal in einem Befehl zählt einmal.
Alles oder nichtsWenn Sie nicht genug Credits für den ganzen Befehl haben, wird nichts validiert und nichts belastet (
INSUFFICIENT_CREDITS).Erstattung bei FehlernWenn die Validierungsserver ausfallen, werden die Credits dieses Befehls zurückerstattet (
VALIDATION_FAILED).Der Verlauf ist kostenloslist_validationsliest, 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.
- 400
INVALID_JSONDer Body ist nicht {"commands":[...]} oder größer als 1 MB.
- 400
INVALID_ARGSDer Request enthält keinen Befehl oder mehr als einen. Diese Route nimmt genau 1 Befehl pro Request.
- 401
MISSING_AUTH_HEADEREs wurde kein Authorization-Header gesendet.
- 401
INVALID_API_KEYDer API key existiert nicht, wurde widerrufen oder im Dashboard deaktiviert.
- 401
API_KEY_EXPIREDDer API key hat das im Dashboard festgelegte Ablaufdatum überschritten.
- 401
WRONG_CREDENTIAL_TYPEEs wurde ein Mailbox-Token gesendet. Die E-Mail-Validierung braucht einen API key aus dem Dashboard.
- 403
IP_NOT_ALLOWEDDer Request kam von einer IP, die nicht zu den erlaubten IPs des Keys gehört.
- 403
ACCOUNT_BLOCKEDDas Konto ist gesperrt.
- 403
MISSING_SCOPEDer Key hat `tools:validate` nicht, daher kann kein Befehl ausgeführt werden.
- 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.
- 503
AUTH_UNAVAILABLEDie Authentifizierung ist vorübergehend nicht verfügbar. Versuchen Sie es erneut.
- CMD
UNKNOWN_COMMANDDer Befehlsname existiert nicht.
- CMD
INTERNALServerfehler. Details werden nur ins Server-Log geschrieben.