# Authentification et clés API

Créez, stockez, limitez et remplacez vos clés API en sécurité

Canonical: https://alef-bot.top/fr/developers/guides/authentication

Updated: 2026-07-13

## Créer une clé

Le tableau de bord protégé est le seul endroit pour gérer les clés. Ouvrez les [paramètres des clés API](/dashboard?modal=settings&tab=public-api), choisissez Test ou Live et accordez les permissions minimales nécessaires

> **Protéger le secret.** La clé n’est affichée qu’une fois. Ne la stockez jamais dans du code navigateur, des URL, des événements d’analyse, des journaux ou le code source

## Envoyer la clé

Envoyez la clé dans chaque requête avec `Authorization: Bearer <api-key>`. Sans clé valide, la réponse utilise une structure d’erreur JSON stable

### cURL

```bash
curl https://alef-bot.top/api/v1/account \
  --header "Authorization: Bearer $ALEFBOT_API_KEY" \
  --header "Accept: application/json"
```

### JavaScript

```javascript
const response = await fetch("https://alef-bot.top/api/v1/account", {
  headers: {
    Authorization: `Bearer ${process.env.ALEFBOT_API_KEY}`,
    Accept: "application/json",
  },
});

if (!response.ok) throw new Error(`AlefBot request failed: ${response.status}`);
const account = await response.json();
```

### Python

```python
import os
import requests

response = requests.get(
    "https://alef-bot.top/api/v1/account",
    headers={"Authorization": f"Bearer {os.environ['ALEFBOT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
account = response.json()
```

## Permissions et remplacement des clés

- Utilisez read_only uniquement pour le suivi et les rapports
- Utilisez full_access uniquement dans les systèmes qui téléversent des médias ou créent des tâches
- Créez une clé de remplacement, déployez-la, vérifiez son utilisation, puis révoquez l’ancienne

## Machine-readable sources

- [OpenAPI JSON](https://alef-bot.top/api/v1/openapi.json)

- [OpenAPI YAML](https://alef-bot.top/api/v1/openapi.yaml)

- [Arazzo workflow](https://alef-bot.top/api/v1/workflows/transcribe.arazzo.yaml)