Email Validator: Disposable
Wegwerfadresse prüfen
Sagt Ihnen in Millisekunden, ob eine Adresse oder Domain eine Wegwerfadresse oder hochriskant ist, damit Sie Fake-Anmeldungen blockieren können. Der Postfachserver wird nicht kontaktiert: Dafür gibt es Validate Email.
https://g.sendcorex.com/v1/tool/validatecommand: check_disposableErfordert den Scope tools:validate für Ihren API key.
Verbraucht 1 Disposable-Credit (keinen Validierungs-Credit). Unlimited-Tarife werden nie belastet.
Senden Sie email oder domain. Bei einer E-Mail wird auch die Betrugsreputation der Adresse geprüft.
Argumente
emailstringoptionalDie zu prüfende Adresse. Bis zu 254 Zeichen.
z. B.
"john@mailinator.com"domainstringoptionalNur die Domain, wenn Sie die vollständige Adresse nicht haben.
z. B.
"mailinator.com"
Schnellstart
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/tool/validate',
{
commands: [
{
command: "check_disposable",
args: {
email: "john@mailinator.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": "check_disposable",
"id": "0",
"type": "SUCCESS",
"took_ms": 2,
"data": {
"email": "john@mailinator.com",
"domain": "mailinator.com",
"is_disposable": true,
"high_risk": true,
"code": "fully_confirmed",
"reason": "Confirmed",
"checks": [
{
"check": "Domain Blocklist Match",
"status": "Failed",
"details": "Domain found in known disposable list"
}
],
"unlimited": false,
"remaining_credits": 4999
}
}
]
}Antwortfelder
emailDie gesendete Adresse, ohne Leerzeichen und in Kleinbuchstaben.
null, wenn Sie nur einedomaingesendet haben.domainDie geprüfte Domain.
is_disposabletruebei temporären/Wegwerf-Anbietern. Blockieren Sie die Anmeldung.high_risktrue, wenn die Adresse eine Wegwerfadresse ist ODER bei Sendcorex bereits wegen Betrugs markiert wurde. Blockieren oder zur Prüfung weiterleiten.codefully_confirmed, wenn etwas gefunden wurde,clear, wenn nicht.reasonEine kurze Erklärung des Urteils.
checksDie ausgeführten Prüfungen (
check,status,details). Siehe Prüfungen unten.remaining_creditsVerbleibende Disposable-Credits nach dieser Prüfung.
nullbei einem Unlimited-Tarif.unlimitedtruebei einem Unlimited-Tarif.
Prüfungen
Von der günstigsten bis zur langsamsten. Eine Domain auf der Blocklist antwortet sofort, ganz ohne DNS-Abfrage.
Email Reputation CheckErscheint nur, wenn sie fehlschlägt: Die Adresse wurde bei Sendcorex wegen Betrugs markiert. Setzt
high_risk, nichtis_disposable.Domain Blocklist MatchDie Domain ist ein bekannter Wegwerf-Anbieter. Schlägt sie fehl, läuft nichts weiter: Die Antwort kommt sofort zurück.
MX Record CheckDie Domain wird auf Infrastruktur gehostet, die von Wegwerf-Anbietern genutzt wird, auch wenn sie noch auf keiner Liste steht.
MX Record PresentInformativ: Die Domain hat MX-Einträge. Eine Domain ohne MX kann keine E-Mails empfangen (oft ein Tippfehler), das allein macht sie aber nicht zur Wegwerfadresse.
Das Ergebnis nutzen
AnmeldeformulareRufen Sie es auf, bevor das Konto erstellt wird. Wenn
is_disposabletrueist, fragen Sie nach einer anderen Adresse.Hohes Risikohigh_riskohneis_disposableist ein echtes Postfach, das bei Sendcorex wegen Betrugs markiert wurde. Blockieren Sie es oder halten Sie das Konto zur Prüfung zurück.Disposable vs. Validate EmailDiese Prüfung ist sofort und günstig. Validate Email fragt zusätzlich den Postfachserver, ob die Adresse existiert, was Sekunden dauert: Verwenden Sie es vor dem Senden.
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
INTERNALServerfehler. Details werden nur ins Server-Log geschrieben.