API V2
Ab sofort ist die Version 2.0 der Captain Verify API mit neuen Funktionen verfügbar. Integrieren Sie die API von Captain Verify in Ihre Anwendungen und überprüfen Sie schnell und zuverlässig die Gültigkeit Ihrer E-Mail-Adressen. Wir empfehlen eine nachgelagerte Verwendung der API, da die Verifizierung bis zu 1 Minute in Anspruch nehmen kann.
API-Schlüssel
Zum Generieren des API-Schlüssels ist ein Benutzerkonto erforderlich.
API – Nutzungslimits
Die API ist auf maximal 2 gleichzeitige Verbindungen und 50 Verifizierungen pro Minute beschränkt. Bitte stellen Sie bei der Integration der API sicher, dass Ihre Anwendung die Anforderungen erfüllt.
Anfrage
Rufen Sie einfach das GET-Protokoll unter der folgenden URL auf, um Anfragen an die API zu senden:
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 diese zu verifizieren.
Antwort
Sie erhalten eine json-Tabelle mit den folgenden Variablen:
{
"credits":870,
"result":"invalid",
"details":"unknown_email",
"free":true,
"role":false,
"disposable":false,
"ok4all":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 Status der E-Mail-Adresse. Wenn Ihre Credits aufgebraucht sind, wird der Status "unbekannt" angezeigt. |
| details | null, email error, greylisting, low quality, low deliverability, mailboxfull... Das bedeuten die Ergebnisse der Verifizierung. |
| free | true, false Für kostenlose E-Mail-Anbieter, z. B. Gmail.com. |
| role | true, false Für E-Mail-Benutzer mit zugewiesener Funktion, z. B. support@example.com. |
| disposable | true, false Diese Wegwerf-E-Mail-Adresse ist zwar gültig, erlaubt aber nach kurzer Zeit keinen Kontakt mehr zum Benutzer. |
| ok4all | true, false Alles OK: Der Mailserver nimmt alle E-Mails an (catch-all). |
| protected | true, false Diese E-Mail-Adresse ist durch einen proprietären Spamfilter geschützt. |
| mailboxfull | true, false Der Posteingang dieser E-Mail-Adresse ist voll und kann keine Nachrichten mehr empfangen. |
| did_you_mean | default : null Wenn diese E-Mail-Adresse beispielsweise john.doe@gmil.com lautet, sendet Ihnen die API einen Vorschlag, z. B. john.doe@gmail.com. |
| Zu verifizierende E-Mail-Adresse. | |
| email_normalized | Die E-Mail-Adresse wurde standardisiert, Tags für Google Mail wurden entfernt ... support+test@gmail.com wird zu support@gmail.com. |
| success | true, false Authentifizierung fehlgeschlagen, Ihre Credits sind aufgebraucht. |
| message | default : null Bei falschen Treffern wird eine Fehlermeldung gesendet. |