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

# Clés API

> Créez et gérez des clés API pour un accès programmatique

## Vue d'ensemble

Les clés API vous permettent de vous authentifier auprès de l'API Orova depuis votre serveur ou le widget intégrable. Elles constituent une alternative aux jetons JWT pour la communication serveur à serveur.

## Créer une clé API

<Steps>
  <Step title="Accédez aux paramètres">
    Dans le tableau de bord, accédez à **Settings → API Keys**.
  </Step>

  <Step title="Créer une clé">
    Cliquez sur **Create API Key** et donnez-lui un nom descriptif.
  </Step>

  <Step title="Copier la clé">
    Copiez la clé immédiatement — elle ne s'affiche qu'une seule fois.
  </Step>
</Steps>

## Utilisation des clés API

Incluez la clé dans l'en-tête `x-api-key` :

```bash theme={null}
curl https://app.orova.ai/api/agents \
  -H "x-api-key: sk_live_abc123..."
```

Ou dans le widget :

```html theme={null}
<script
  src="https://app.orova.ai/widget/orova-widget.js"
  data-api-key="sk_live_abc123..."
  ...
></script>
```

## Bonnes pratiques de sécurité

* N'exposez jamais les clés API dans le JavaScript côté client (sauf pour l'attribut `data-api-key` du widget)
* Effectuez une rotation des clés régulièrement
* Utilisez des clés distinctes pour les différents environnements (dev, staging, production)
* Supprimez rapidement les clés inutilisées