> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enrow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Paramètres API

> Configurez l'accès à l'API Enrow, votre clé API, une URL de webhook par défaut et le paramètre country_code depuis le tableau de bord

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](/fr/credits-billing).

## Où trouver ma clé API ?

Votre clé API se trouve dans le [tableau de bord Enrow](https://app.enrow.io) — 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](/fr/authentication).

<Warning>
  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.
</Warning>

## 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](/fr/how-webhooks-work).

## À 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`.

<Info>
  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.
</Info>

Le code pays est particulièrement utile pour les **homonymes** — des entreprises qui portent le même nom dans différents pays :

```json theme={null}
// 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](/fr/api-reference/email-finder/find-single) pour la liste complète des paramètres disponibles.

## FAQ

<AccordionGroup>
  <Accordion title="Ai-je besoin d'une clé API distincte par endpoint ?">
    Non. Une seule clé API authentifie chaque endpoint — [Email Finder](/fr/api-reference/email-finder/find-single), [Email Verifier](/fr/api-reference/email-verifier/verify-single) et [Phone Finder](/fr/api-reference/phone/find-single). Passez la clé dans l'en-tête `x-api-key` à chaque requête.
  </Accordion>

  <Accordion title="country_code fonctionne-t-il avec company_domain ?">
    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.
  </Accordion>

  <Accordion title="Que se passe-t-il si je définis à la fois un webhook dans le tableau de bord et un webhook par requête ?">
    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`.
  </Accordion>
</AccordionGroup>

## Étapes suivantes

<CardGroup cols={2}>
  <Card title="Authentification" icon="key" href="/fr/authentication">
    Comment passer votre clé API dans l'en-tête x-api-key.
  </Card>

  <Card title="Comment fonctionnent les webhooks" icon="bell" href="/fr/how-webhooks-work">
    Configurez les webhooks pour être notifié à la fin d'une recherche.
  </Card>

  <Card title="Crédits et facturation" icon="coins" href="/fr/credits-billing">
    Découvrez comment les crédits sont consommés pour chaque endpoint.
  </Card>

  <Card title="Trouver un email" icon="envelope" href="/fr/api-reference/email-finder/find-single">
    Lancez une recherche d'email unique avec des paramètres personnalisés.
  </Card>
</CardGroup>