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

# Authentification

> How to authenticate Enrow API requests with your API key in the x-api-key header

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](https://app.enrow.io)
2. Cliquez sur **API** dans le menu de gauche
3. Copiez votre clé API

<Warning>
  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](#best-practices).
</Warning>

## Comment authentifier une requête ?

Incluez votre clé API dans l''en-tête `x-api-key` pour chaque requête :

<CodeGroup>
  ```bash cURL theme={null}
  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"
    }'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.enrow.io/email/find/single', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      fullname: 'John Doe',
      company_domain: 'example.com'
    })
  });

  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  url = "https://api.enrow.io/email/find/single"
  headers = {
      "Content-Type": "application/json",
      "x-api-key": "YOUR_API_KEY"
  }
  payload = {
      "fullname": "John Doe",
      "company_domain": "example.com"
  }

  response = requests.post(url, json=payload, headers=headers)
  data = response.json()
  ```
</CodeGroup>

Le même en-tête `x-api-key` fonctionne pour tous les points de terminaison — [Email Finder](/fr/api-reference/email-finder/find-single), [Email Verifier](/fr/api-reference/email-verifier/verify-single), [Phone Finder](/fr/api-reference/phone/find-single) et [Informations du compte](/fr/api-reference/account/info).

## 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 :

```json theme={null}
{
  "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](/fr/status-codes) et [Gestion des erreurs](/fr/error-handling).

## 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 :

```bash theme={null}
curl https://api.enrow.io/account/info \
  -H "x-api-key: YOUR_API_KEY"
```

```json Response theme={null}
{
  "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](/fr/credits-billing).

## Bonnes pratiques

<AccordionGroup>
  <Accordion title="Utiliser des variables d''environnement">
    Stockez votre clé API dans des variables d''environnement plutôt que de la coder en dur :

    ```bash theme={null}
    export ENROW_API_KEY="your_api_key_here"
    ```
  </Accordion>

  <Accordion title="Renouveler régulièrement les clés">
    Pour une sécurité renforcée, renouvelez périodiquement vos clés API et révoquez les clés inutilisées.
  </Accordion>

  <Accordion title="Utiliser des clés différentes selon les environnements">
    Créez des clés API distinctes pour les environnements de développement, de préproduction et de production.
  </Accordion>
</AccordionGroup>

## Étapes suivantes

<CardGroup cols={2}>
  <Card title="Trouver un email" icon="envelope" href="/fr/api-reference/email-finder/find-single">
    Recherchez une adresse email professionnelle à partir d''un nom et d''une entreprise.
  </Card>

  <Card title="Vérifier un email" icon="circle-check" href="/fr/api-reference/email-verifier/verify-single">
    Vérifiez si une adresse email est valide et délivrable.
  </Card>

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

  <Card title="Limites de débit" icon="gauge-high" href="/fr/rate-limits">
    Comprenez les limites de requêtes de l''API avant de passer à l''échelle.
  </Card>
</CardGroup>
