Skip to main content
Les paramètres API déterminent la façon dont vous accédez à l’API Enrow et son comportement à chaque requête. Cette page explique qui peut accéder à l’API, où trouver votre clé API, comment définir une URL de webhook par défaut et comment le paramètre country_code modifie le comportement de recherche.

​
Qui peut accéder à l’API Enrow ?

L’API Enrow est disponible pour les clients disposant d’un abonnement actif ou de crédits à l’usage. Si votre compte n’a ni l’un ni l’autre, la section API ne sera pas accessible. Pour savoir comment les crédits sont consommés par endpoint, consultez Crédits et facturation.

​
Où trouver ma clé API ?

Votre clé API se trouve dans le tableau de bord Enrow — cliquez sur API dans le menu de gauche et copiez la clé. La même clé authentifie chaque endpoint via l’en-tête x-api-key. Pour des exemples de requêtes et la gestion des erreurs, consultez Authentification.
Gardez votre clé API en sécurité. Ne commitez jamais la clé API dans un système de gestion de versions et ne la partagez jamais publiquement. Traitez-la comme un mot de passe.

​
Comment définir une URL de webhook par défaut ?

Vous pouvez définir une URL de webhook par défaut sur la page API du tableau de bord. Enrow vérifie l’URL au moment où vous l’enregistrez : consultez Comment vérifier mon endpoint de webhook ?. Cette URL est utilisée chaque fois qu’aucun webhook n’est spécifié dans une requête individuelle, ce qui vous évite de la répéter à chaque appel. Lorsqu’une requête inclut un webhook dans son objet settings, celui-ci remplace la valeur par défaut du tableau de bord pour les requêtes Phone Finder et Email Verifier. Pour les requêtes Email Finder, Enrow notifie les deux URL. Pour les formats de payload, les livraisons et la sécurité, consultez Comment fonctionnent les webhooks.

​
À quoi sert le paramètre country_code ?

Le paramètre country_code (ISO 3166-1 alpha-2) définit quelle version locale de Google l’API utilise pour identifier une entreprise. Passez-le dans l’objet settings de votre requête. Si rien n’est fourni, la valeur par défaut est US.
Le code pays n’est utile que lors d’une recherche avec company_name (et non company_domain). Il indique à Enrow quelle version locale de Google utiliser pour identifier l’entreprise — par exemple, google.de pour l’Allemagne ou google.fr pour la France.
Le code pays est particulièrement utile pour les homonymes — des entreprises qui portent le même nom dans différents pays :
L’objet settings accepte également webhook (une URL de webhook propre à la requête) et retrieve_gender (booléen). Consultez la référence Trouver un email pour la liste complète des paramètres disponibles.

​
FAQ

Non. Une seule clé API authentifie chaque endpoint — Email Finder, Email Verifier et Phone Finder. Passez la clé dans l’en-tête x-api-key à chaque requête.
Non. Le paramètre country_code n’affecte que les recherches qui utilisent company_name. Lorsque vous passez un company_domain, le domaine identifie déjà l’entreprise, le code pays n’a donc aucun effet.
Cela dépend de l’endpoint. Pour les recherches Email Finder, Enrow envoie le résultat aux deux URL (une seule fois si elles sont identiques). Pour les recherches Phone Finder et les vérifications Email Verifier, le webhook par requête défini dans l’objet settings remplace la valeur par défaut du tableau de bord, qui n’est utilisée que lorsqu’une requête n’inclut pas sa propre URL webhook.

​
Étapes suivantes

Authentification

Comment passer votre clé API dans l’en-tête x-api-key.

Comment fonctionnent les webhooks

Configurez les webhooks pour être notifié à la fin d’une recherche.

Crédits et facturation

Découvrez comment les crédits sont consommés pour chaque endpoint.

Trouver un email

Lancez une recherche d’email unique avec des paramètres personnalisés.