Passer au contenu principal
L”API Enrow utilise l”authentification par clé API. Chaque requête doit inclure votre clé API dans l”en-tête x-api-key. Il n”y a aucun flux OAuth ni jeton bearer à gérer — une seule clé API authentifie tous les points de terminaison.

​
Comment obtenir ma clé API ?

  1. Inscrivez-vous sur app.enrow.io
  2. Cliquez sur API dans le menu de gauche
  3. Copiez votre clé API
Conservez votre clé API en lieu sûr et ne la committez jamais dans un gestionnaire de versions. Traitez-la comme un mot de passe. Si une clé est exposée, renouvelez-la — voir Bonnes pratiques.

​
Comment authentifier une requête ?

Incluez votre clé API dans l”en-tête x-api-key pour chaque requête : 
curl --request POST \
  --url https://api.enrow.io/email/find/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "fullname": "John Doe",
    "company_domain": "example.com"
  }'
Le même en-tête x-api-key fonctionne pour tous les points de terminaison — Email Finder, Email Verifier, Phone Finder et Informations du compte.

​
Pourquoi est-ce que je reçois une erreur 401 ?

Une réponse 401 Unauthorized signifie que votre clé API est manquante ou invalide. Si la clé API est invalide, vous recevrez : 
{
  "message": "This apikey is not valid"
}
Si aucune clé API n”est fournie, le message est plutôt "No apikey found in the x-api-key headers". Pour la liste complète des codes de statut et des formats d”erreur, voir Codes de statut et Gestion des erreurs.

​
Comment vérifier mon compte et mes crédits ?

Vous pouvez récupérer les informations de votre compte (solde de crédits et webhooks enregistrés) en utilisant le même en-tête x-api-key — aucun corps de requête n”est nécessaire : 
curl https://api.enrow.io/account/info \
  -H "x-api-key: YOUR_API_KEY"
Response
{
  "credits": 8500,
  "webhooks": ["https://your-app.com/webhooks/enrow"]
}
Pour comprendre comment les crédits sont consommés par point de terminaison, voir Crédits et facturation.

​
Bonnes pratiques

Stockez votre clé API dans des variables d”environnement plutôt que de la coder en dur :
export ENROW_API_KEY="your_api_key_here"
Pour une sécurité renforcée, renouvelez périodiquement vos clés API et révoquez les clés inutilisées.
Créez des clés API distinctes pour les environnements de développement, de préproduction et de production.

​
Étapes suivantes

Trouver un email

Recherchez une adresse email professionnelle à partir d”un nom et d”une entreprise.

Vérifier un email

Vérifiez si une adresse email est valide et délivrable.

Crédits et facturation

Découvrez comment les crédits sont consommés pour chaque point de terminaison.

Limites de débit

Comprenez les limites de requêtes de l”API avant de passer à l”échelle.