API-Dokumentation — VerifyEmail

Schnellstart

Erstellen Sie im Dashboard einen API-Schlüssel, speichern Sie ihn sicher auf dem Server und senden Sie ihn als Bearer-Anmeldedaten. Jede angenommene Verifizierungsanfrage verbraucht ein Guthaben.

Anfrage

curl -sS -X POST 'https://api.verifyemail.net/api/v1/verifications' \
  -H 'Authorization: Bearer ve_live_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{"address":"[email protected]"}'

Antwort · HTTP 200

{
  "errcode": 0,
  "address": "[email protected]",
  "is_deliverable": true,
  "status": 250,
  "catch_all": false,
  "disposable": false
}

Authentifizierung

Erstellen Sie einen API-Schlüssel im Dashboard: Dashboard → API-Schlüssel

Der vollständige Wert ve_live_… wird nur einmal angezeigt.

Bewahren Sie API-Schlüssel als serverseitige Geheimnisse auf. Verwenden Sie sie nie in Browsercode, Abfrageparametern, öffentlichen Repositories oder sichtbaren Client-Logs.

Authorization: Bearer ve_live_your_api_key

E-Mail verifizieren

POST/verifications

Anfrageinhalt

Feld	Typ	Erforderlich	Beschreibung
address	string	Ja	Eine vollständige E-Mail-Adresse.

Antwortfelder

Feld	Typ	Beschreibung
errcode	number	0 bedeutet Erfolg; andere Werte werden anhand der Fehlertabelle behandelt.
address	string	Die normalisierte E-Mail-Adresse.
is_deliverable	boolean	Ob der empfangende Server den Empfänger akzeptiert.
status	number \| null	Der numerische SMTP-Antwortcode oder null, wenn keine SMTP-Antwort empfangen wurde.
catch_all	boolean \| null	Ob die Domain jeden Empfänger akzeptiert. Null bedeutet, dass keine zuverlässige Aussage möglich ist.
disposable	boolean	Ob die Adresse zu einer Wegwerf-E-Mail-Domain gehört.

250 · HTTP 200 · errcode 0

Der empfangende Server hat den Empfänger akzeptiert.

550 · HTTP 200 · errcode 0

Die Domain oder der empfangende Server hat den Empfänger abgelehnt.

null · HTTP 422

Die Adresse ist ungültig oder kann nicht verifiziert werden.

null · HTTP 503

Es ist keine zuverlässige Aussage möglich; versuchen Sie es später erneut.

Alternativ steht der folgende GET-Endpunkt bereit. POST wird empfohlen, damit Adressen nicht in Proxy-Logs oder im Browserverlauf erscheinen: /verifications?address=…

Verbleibendes Guthaben prüfen

GET/usage

Diese Anfrage verbraucht kein Verifizierungsguthaben. Dashboard-Sitzungen und alle API-Schlüssel desselben Benutzers teilen sich ein Guthaben.

Anfrage

curl -sS 'https://api.verifyemail.net/api/v1/usage' \
  -H 'Authorization: Bearer ve_live_your_api_key'

Antwort · HTTP 200

{
  "errcode": 0,
  "verification_limit": 100,
  "verification_used": 1,
  "remaining_verifications": 99,
  "unlimited": false
}

Feld	Typ	Beschreibung
verification_limit	number	Das aktuelle Gesamtlimit. Null bedeutet unbegrenzt.
verification_used	number	Die bereits verwendeten Verifizierungen.
remaining_verifications	number \| null	Noch verfügbare Verifizierungen; bei unbegrenzten Konten null.
unlimited	boolean	Ob das aktuelle Kontingent unbegrenzt ist.

Unbegrenzte Tarife liefern remaining_verifications: null, unlimited: true.

Fehlercodes

Verwenden Sie den numerischen errcode für die Programmlogik. Der lesbare message-Text kann sich ändern.

Fehlerantwort

{
  "errcode": 10006,
  "message": "request rate limit exceeded"
}

errcode	HTTP	Bedeutung
0	2xx	Anfrage erfolgreich.
10000	400	Fehlerhafte Anfrage; prüfen Sie JSON, Header und HTTP-Methode.
10001	400 / 422	Ein Parameter oder eine Geschäftsregel ist ungültig.
10002	401	Anmeldedaten fehlen, sind ungültig oder abgelaufen.
10003	403	Das Konto darf nicht auf diese Ressource zugreifen.
10004	404	Die angeforderte Ressource existiert nicht.
10005	409	Die Ressource steht im Konflikt mit dem aktuellen Zustand.
10006	429	Das Anfragelimit pro Sekunde wurde überschritten.
10007	429	Das Verifizierungsguthaben ist aufgebraucht.
10008	429	Die gleichzeitige Dienstkapazität ist ausgelastet.
10009	500	Ein interner Dienstfehler ist aufgetreten.
10010	503	Der Dienst ist vorübergehend nicht verfügbar oder nicht konfiguriert.
10011	502	Ein vorgelagerter Dienst hat einen Fehler gemeldet.

Rate-Limit-Header

Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset — beschreiben das aktuelle Anfragefenster.

Bereit für Ihre erste Anfrage?Erstellen Sie ein Konto und erhalten Sie 100 Verifizierungsguthaben.