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.

POSThttps://g.sendcorex.com/v1/tool/validatecommand: check_disposable
i

Erfordert den Scope tools:validate für Ihren API key.

i

Verbraucht 1 Disposable-Credit (keinen Validierungs-Credit). Unlimited-Tarife werden nie belastet.

i

Senden Sie email oder domain. Bei einer E-Mail wird auch die Betrugsreputation der Adresse geprüft.

Argumente

  • emailstringoptional

    Die zu prüfende Adresse. Bis zu 254 Zeichen.

    z. B. "john@mailinator.com"

  • domainstringoptional

    Nur 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

  • email

    Die gesendete Adresse, ohne Leerzeichen und in Kleinbuchstaben. null, wenn Sie nur eine domain gesendet haben.

  • domain

    Die geprüfte Domain.

  • is_disposable

    true bei temporären/Wegwerf-Anbietern. Blockieren Sie die Anmeldung.

  • high_risk

    true, wenn die Adresse eine Wegwerfadresse ist ODER bei Sendcorex bereits wegen Betrugs markiert wurde. Blockieren oder zur Prüfung weiterleiten.

  • code

    fully_confirmed, wenn etwas gefunden wurde, clear, wenn nicht.

  • reason

    Eine kurze Erklärung des Urteils.

  • checks

    Die ausgeführten Prüfungen (check, status, details). Siehe Prüfungen unten.

  • remaining_credits

    Verbleibende Disposable-Credits nach dieser Prüfung. null bei einem Unlimited-Tarif.

  • unlimited

    true bei 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 Check

    Erscheint nur, wenn sie fehlschlägt: Die Adresse wurde bei Sendcorex wegen Betrugs markiert. Setzt high_risk, nicht is_disposable.

  • Domain Blocklist Match

    Die Domain ist ein bekannter Wegwerf-Anbieter. Schlägt sie fehl, läuft nichts weiter: Die Antwort kommt sofort zurück.

  • MX Record Check

    Die Domain wird auf Infrastruktur gehostet, die von Wegwerf-Anbietern genutzt wird, auch wenn sie noch auf keiner Liste steht.

  • MX Record Present

    Informativ: 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

  • Anmeldeformulare

    Rufen Sie es auf, bevor das Konto erstellt wird. Wenn is_disposable true ist, fragen Sie nach einer anderen Adresse.

  • Hohes Risiko

    high_risk ohne is_disposable ist 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 Email

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

  • 401INVALID_API_KEY

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

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

  • CMDMISSING_SCOPE

    Der API key hat `tools:validate` nicht.

  • CMDINVALID_ARGS

    Ein 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…

  • CMDINSUFFICIENT_CREDITS

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

  • CMDCREDITS_UNAVAILABLE

    Ihre Credits konnten gerade nicht gelesen werden. Nichts wurde belastet. Versuchen Sie es erneut.

  • CMDINTERNAL

    Serverfehler. Details werden nur ins Server-Log geschrieben.