Passer au contenu principal
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 configurer une URL de webhook par défaut dans le tableau de bord. 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. Un webhook défini par requête dans l’objet settings remplace toujours la valeur par défaut du tableau de bord. Pour les formats de payload, les tentatives de renvoi 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 : 
// Dove the soap brand (UK)
{
  "company_name": "Dove",
  "fullname": "John Doe",
  "settings": { "country_code": "GB" }
}

// Dove the chocolate brand (Germany)
{
  "company_name": "Dove",
  "fullname": "Hans Müller",
  "settings": { "country_code": "DE" }
}
L’objet settings accepte également webhook (une URL de webhook propre à la requête), retrieve_gender (booléen) et retrieve_company_info (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.
Le webhook par requête défini dans l’objet settings est prioritaire. La valeur par défaut du tableau de bord 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.