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

# Utilisation

> Suivez l'utilisation de l'API Enrow et la consommation de crédits, et optimisez vos requêtes avec les endpoints groupés, les webhooks et la mise en cache

Cette page explique comment surveiller l'utilisation de votre API Enrow et la consommation de crédits, et comment optimiser vos requêtes pour dépenser moins de crédits. Pour comprendre la tarification des crédits par endpoint, consultez [Crédits et facturation](/fr/credits-billing).

## Comment suivre l'utilisation de mon API ?

Vous pouvez suivre l'utilisation de l'API Enrow de deux manières : visuellement dans le tableau de bord, ou par programmation via l'endpoint de compte.

### Où puis-je voir l'utilisation dans le tableau de bord ?

Le [tableau de bord Enrow](https://app.enrow.io) offre une vue en temps réel de votre utilisation :

* Crédits consommés au fil du temps
* Répartition par endpoint
* Taux de réussite et d'échec
* Crédits restants

### Comment vérifier l'utilisation avec l'API ?

Interrogez l'endpoint de compte pour vérifier l'utilisation par programmation. Authentifiez la requête avec votre [clé API](/fr/authentication) dans l'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"]
}
```

La valeur `credits` correspond à votre solde restant, et `webhooks` liste les URL enregistrées sur votre compte. Consultez la référence [Informations du compte](/fr/api-reference/account/info) pour le schéma de réponse complet.

## Comment optimiser l'utilisation de mon API ?

Pour réduire la consommation de crédits et rester dans vos [limites de débit](/fr/rate-limits), regroupez vos requêtes avec les endpoints groupés, recevez les résultats via des webhooks au lieu d'interroger l'API, et mettez en cache les résultats que vous avez déjà récupérés.

<AccordionGroup>
  <Accordion title="Utiliser les endpoints groupés">
    Au lieu d'effectuer de nombreuses requêtes individuelles, regroupez-les (jusqu'à 5 000 entrées par requête groupée d'emails, 3 000 par requête groupée de téléphones) :

    ```javascript theme={null}
    // ❌ 100 separate requests
    for (const contact of contacts) {
      await findEmail(contact);
    }

    // ✅ 1 bulk request
    await findEmailsBulk(contacts);
    ```

    Consultez [Trouver des emails](/fr/api-reference/email-finder/find-bulk) et [Trouver des téléphones](/fr/api-reference/phone/find-bulk) pour les opérations groupées.
  </Accordion>

  <Accordion title="Utiliser les webhooks plutôt que le polling">
    Le polling gaspille des crédits et le quota de votre limite de débit. Utilisez les webhooks pour recevoir les résultats automatiquement :

    ```json theme={null}
    {
      "fullname": "John Doe",
      "company_domain": "example.com",
      "settings": {
        "webhook": "https://your-app.com/webhook"
      }
    }
    ```

    Découvrez comment fonctionne la livraison dans [Fonctionnement des webhooks](/fr/how-webhooks-work).
  </Accordion>

  <Accordion title="Mettre les résultats en cache">
    Stockez les résultats pour éviter des appels d'API redondants pour le même contact.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="L'endpoint d'utilisation coûte-t-il des crédits ?">
    Non. L'interrogation de l'endpoint [Informations du compte](/fr/api-reference/account/info) renvoie vos crédits restants et vos webhooks enregistrés sans consommer de crédits.
  </Accordion>

  <Accordion title="Les recherches échouées consomment-elles des crédits ?">
    Les crédits sont consommés selon les règles décrites dans [Crédits et facturation](/fr/credits-billing). Lorsqu'une requête échoue avant traitement — par exemple une réponse `402 Insufficient credits` — aucun crédit n'est déduit. Consultez [Gestion des erreurs](/fr/error-handling) et [Codes de statut](/fr/status-codes) pour les formats de réponse.
  </Accordion>

  <Accordion title="Comment éviter d'atteindre les limites de débit ?">
    Regroupez vos requêtes avec les endpoints groupés et utilisez les webhooks plutôt que le polling pour récupérer les résultats. Les deux réduisent le nombre d'appels que vous effectuez. Consultez [Limites de débit](/fr/rate-limits) pour les limites de requêtes actuelles.
  </Accordion>
</AccordionGroup>

## Étapes suivantes

<CardGroup cols={2}>
  <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="Informations du compte" icon="circle-user" href="/fr/api-reference/account/info">
    Récupérez votre solde de crédits et vos webhooks enregistrés.
  </Card>

  <Card title="Webhooks" icon="bell" href="/fr/how-webhooks-work">
    Recevez les résultats automatiquement au lieu d'interroger l'API.
  </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 monter en charge.
  </Card>
</CardGroup>