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

# Authentification

> Chaque requête est authentifiée par une clé API dans le header X-API-Key.

Toutes les requêtes (sauf `/api/status`) exigent votre clé API dans le header **`X-API-Key`**.

```bash theme={null}
curl https://api.apinn.io/api/sports \
  -H "X-API-Key: pnk_votre_cle"
```

## Obtenir & gérer votre clé

Votre clé est émise à l'inscription et visible dans votre [espace client](https://www.apinn.io/account). Vous pouvez la **régénérer** à tout moment — l'ancienne est alors invalidée immédiatement.

<Warning>
  Ne partagez jamais votre clé et ne l'exposez pas côté navigateur. Appelez l'API depuis votre serveur.
</Warning>

## Réponses d'erreur

| Code  | Signification                                         |
| ----- | ----------------------------------------------------- |
| `401` | Clé manquante, invalide ou révoquée.                  |
| `429` | Quota horaire dépassé — voir le header `Retry-After`. |
| `422` | Paramètre requis manquant (ex. `event_id`).           |

```json 401 theme={null}
{ "detail": "Not authenticated" }
```

Voir [Quotas & limites](/rate-limits) pour le détail du header `Retry-After` et du comptage.