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

# Générer une clé d'API

> Créez dans le tableau de bord Scanova une clé d'API limitée à un site pour les événements serveur. La clé ne s'affiche qu'une fois : conservez-la bien.

Chaque site de suivi a ses propres clés d'API. Une clé est limitée à un seul site : elle ne permet d'envoyer des événements que pour le `site_id` de ce site.

## Étapes

1. Connectez-vous au tableau de bord Scanova
2. Allez dans **Analyses → Suivi des conversions**
3. Cliquez sur votre site de suivi pour ouvrir ses détails
4. Sélectionnez **Configuration du suivi** sur votre site, puis l'onglet **Suivre via l'API**
5. Cliquez sur **Generate API Key**
6. Saisissez un nom parlant (par exemple `Production Backend` ou `Checkout Service`)
7. Cliquez sur **Generate**
8. **Copiez la clé immédiatement** — elle ne s'affiche qu'une seule fois

<Warning>
  La clé d'API en clair ne s'affiche qu'une seule fois. Si vous fermez la fenêtre sans la copier, vous devrez la révoquer et en générer une autre.
</Warning>

## Conserver la clé en sécurité

Enregistrez la clé dans une variable d'environnement de votre backend. Ne l'écrivez jamais en dur dans le code source.

```bash theme={null}
# .env
SCANOVA_API_KEY=your_key_here
```

```javascript theme={null}
// Node.js
const apiKey = process.env.SCANOVA_API_KEY;
```

```python theme={null}
# Python
import os
api_key = os.environ['SCANOVA_API_KEY']
```

## Limites et gestion des clés

* Un site peut avoir **jusqu'à 2 clés d'API actives** à la fois. Retirez une ancienne clé lorsque vous en créez une nouvelle
* Révoquez sans attendre les clés inutilisées ou compromises depuis l'onglet **Suivre via l'API**
* Avec un plafond de deux, séparer production et préproduction occupe les deux places : prévoyez le renouvellement en conséquence

## Utiliser la clé

Envoyez-la en en-tête de chaque requête d'événement serveur :

```http theme={null}
POST /server-events HTTP/1.1
Host: track.scanova.io
Content-Type: application/json
X-API-Key: YOUR_API_KEY
```

La clé doit correspondre au `site_id` que vous indiquez dans le corps de la requête. En cas de décalage, la réponse est `403`.

## Étape suivante

[Envoyer votre premier événement serveur →](/fr/conversion-tracking/server/send-events)