Authentifizierung

Alle API-Anfragen brauchen einen gültigen API-Schlüssel, der als Bearer-Token übergeben wird.

Bearer-Token

Authentifiziere dich, indem du deinen API-Schlüssel in jeder Anfrage im Authorization Header mitschickst:

Authorization: Bearer YOUR_API_KEY

Dein API-Schlüssel ist eine lange Zeichenkette, die beginnt mit ev_. Zum Beispiel:

Authorization: Bearer ev_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Wo du deinen API-Schlüssel findest

1. Melde dich in deinem Konto an unter verimails.com/dashboard
2. Geh zu Settings → API Keys
3. Kopiere deinen Schlüssel

Beispiel für eine authentifizierte Anfrage

curl -X POST https://verimails.com/api/verify/single \
  -H "Authorization: Bearer ev_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"email": "test@example.com"}'

Authentifizierungsfehler

Fehlt dein Schlüssel oder ist er ungültig, bekommst du eine 401 Unauthorized Antwort:

{
  "error": "Unauthorized",
  "message": "Invalid or missing API key",
  "status_code": 401
}