API V2
Version 2 der Captain Verify API ist jetzt verfügbar und enthält neue Funktionen. Wenn Sie nach einer zuverlässigen Möglichkeit suchen, die Gültigkeit Ihrer E-Mails zu überprüfen, können Sie die E-Mail-Verifizierungs-API von Captain Verify in Ihre eigenen Anwendungen integrieren. Wir empfehlen, die API im Nachhinein zu verwenden, da eine Überprüfung mehr oder weniger lang sein kann (1 Minute).
API-Schlüssel
Zum Generieren des Schlüssels für die API ist ein Konto erforderlich. Dadurch erhalten Sie Zugriff auf den Dienst.
API-Grenzen
Die API ist auf maximal 2 gleichzeitige Verbindungen und 50 Prüfungen pro Minute beschränkt. Stellen Sie bei der Integration der API sicher, dass Ihre Anwendung diese Grenze nicht überschreitet.
Die Anfrage
Um eine Anfrage an die API zu stellen, rufen Sie einfach das GET-Protokoll unter dieser URL auf:
https://api.captainverify.com/v2/verify?apikey=XXXXXXXXXXXXXXXXXXXX&email=john.doe@gmail.com
Ersetzen Sie john.doe@gmail.com durch Ihre E-Mail-Adresse, um sie zu bestätigen.
Die Antwort
Eine json-Tabelle wird mit diesen Variablen zurückgegeben:
{
"credits":870,
"result":"invalid",
"details":"unknown_email",
"free":true,
"role":false,
"disposable":false,
"ok_for_all":false,
"protected":false,
"did_you_mean":"john.doe@gmail.com",
"email":"john.doe@gmail.com",
"email_normalized":"john.doe@gmail.com",
"success":true,
"message":null
}
Variablen | Möglicher Wert |
---|---|
credits | Auf Ihrem Konto verfügbare Credits. |
result | valid, invalid, risky, unknown Der Status der E-Mail. wenn alle Ihre Credits aufgebraucht sind, wird immer der unbekannte Status zurückgegeben, um Ihre Bewerbung nicht zu blockieren. |
details | null, email error, greylisting, low quality, low deliverability, mailboxfull... Verstehen Sie das Ergebnis eines Audits. |
free | true, false Wenn der E-Mail-Anbieter kostenlos ist, z. B. Gmail.com. |
role | true, false Wenn der E-Mail-Benutzer eine Rolle hat, z. B.: support@example.com. |
disposable | true, false Die E-Mail ist gültig, aber nach kurzer Zeit ist es nicht mehr möglich, den Benutzer zu kontaktieren. |
ok_for_all | true, false Alles klar: Der entfernte Mailserver nimmt alle E-Mails an (catch-all). |
protected | true, false Die E-Mail ist durch eine proprietäre Antispam-Lösung geschützt |
mailboxfull | true, false Die E-Mail-Adresse ist voll. Sie kann keine Post mehr empfangen |
did_you_mean | default : null Wenn die E-Mail beispielsweise john.doe@gmil.com lautet, sendet Ihnen die API einen Vorschlag wie john.doe@gmil.com. |
Die E-Mail, die Sie bestätigen möchten. | |
email_normalized | E-Mail hat sich normalisiert, Tags für Google Mail werden entfernt ... support+test@gmail.com wird zu support@gmail.com. |
success | true, false Wenn die Authentifizierung fehlgeschlagen ist, sind Ihre Credits erschöpft. |
message | default : null Wenn der Erfolg falsch ist, wird eine Fehlermeldung gesendet. |