So funktioniert es

Um eine beliebige Domain abzufragen, sende bitte eine Anfrage über GET an folgende Adresse.

https://api.block-trashmail.de/check/example.com

Ersetze hierbei example.com gegen die Domain, die du auf einen Anbieter von Wegwerf-E-Mail-Adressen prüfen möchtest.

Wir werden dir eines von drei möglichen Ergebnissen zurückmelden. Diese findest du nachfolgend exemplarisch aufgelistet.

Mögliche Ergebnisse für eine Anfrage

{
   "error": false,
   "results": {
      "domain": "example.com",
      "listed": true
   }
}

Domain in der Datenbank

Die Domain example.com wurde in unserer Datenbank gefunden (listed = true).

{
   "error": false,
   "results": {
      "domain": "example.com",
      "listed": false
   }
}

Domain nicht in der Datenbank

Die Domain example.com ist nicht in unserer Datenbank vorhanden (listed = false).

{
   "error": {
      "code": 400,
      "message": "Invalid domain name."
   },
   "results": null
}

Fehler bei der Anfrage

Die Anfrage enthält einen Fehler, häufige Ursache ist eine ungültige Domain. Bitte beachte zudem, dass wir seit Oktober 2020 nur noch Domains, aber keine E-Mail-Adressen mehr prüfen.

Limitierungen

Je IP-Adresse maximal 150 Abfragen innerhalb von 24 Stunden. Zusätzlich sind nur eine bestimmte Anzahl an Anfragen innerhalb einer Zeit möglich. Dies wird dynamisch behandelt und sollte dich nicht weiter betreffen, wenn du nicht massenhaft Anfragen sendest.