Authentification

Toutes les requêtes API nécessitent une clé API valide transmise sous forme de jeton Bearer.

Jeton Bearer

Authentifiez-vous en incluant votre clé API dans l'en-tête Authorization de chaque requête :

http

Authorization: Bearer YOUR_API_KEY

Votre clé API est une longue chaîne de caractères commençant par ev_. Par exemple :

http

Authorization: Bearer ev_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Où trouver votre clé API

Connectez-vous à votre compte sur verimails.com/dashboard
Rendez-vous dans Paramètres → Clés API
Copiez votre clé

⚠️

Gardez votre clé API secrète. Ne l'intégrez jamais dans du JavaScript côté client ni dans un dépôt public, et ne la partagez jamais avec des tiers non fiables. En cas de compromission, régénérez-la immédiatement depuis le tableau de bord.

Exemple de requête authentifiée

bash

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

Erreurs d'authentification

Si votre clé est absente ou invalide, vous recevrez une réponse 401 Unauthorized :

json

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

ℹ️

Besoin de plusieurs clés API pour différents environnements ou applications ? Vous pouvez générer des clés supplémentaires depuis le tableau de bord.