Authenticatie

Alle API-requests vereisen een geldige API-sleutel die als Bearer-token wordt meegestuurd.

Bearer-token

Authenticeer door je API-sleutel op te nemen in de Authorization header van elke request:

Authorization: Bearer YOUR_API_KEY

Je API-sleutel is een lange string die begint met ev_. Bijvoorbeeld:

Authorization: Bearer ev_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Waar vind je je API-sleutel

1. Log in op je account via verimails.com/dashboard
2. Ga naar Settings → API Keys
3. Kopieer je sleutel

Voorbeeld van een geauthenticeerde request

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"}'

Authenticatiefouten

Ontbreekt je sleutel of is die ongeldig, dan krijg je een 401 Unauthorized response:

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