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

# Autenticazione

> Ogni richiesta è autenticata da una chiave API nell'header X-API-Key.

Tutte le richieste (tranne `/api/status`) richiedono la tua chiave API nell'header **`X-API-Key`**.

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

## Ottenere & gestire la tua chiave

La tua chiave viene emessa all'iscrizione ed è visibile nella tua [area cliente](https://www.apinn.io/account). Puoi **rigenerarla** in qualsiasi momento — la vecchia viene allora invalidata immediatamente.

<Warning>
  Non condividere mai la tua chiave e non esporla lato browser. Chiama l'API dal tuo server.
</Warning>

## Risposte di errore

| Codice | Significato                                          |
| ------ | ---------------------------------------------------- |
| `401`  | Chiave mancante, non valida o revocata.              |
| `429`  | Quota oraria superata — vedi l'header `Retry-After`. |
| `422`  | Parametro obbligatorio mancante (es. `event_id`).    |

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

Vedi [Quote & limiti](/it/rate-limits) per i dettagli dell'header `Retry-After` e del conteggio.