# Chiavi API

Per [utilizzare la nostra API](/docs/api), devi [generare una chiave API](/keys/api).

Una volta ottenuta la chiave, puoi utilizzarla per autenticare le tue richieste verso la nostra API.

Con [`curl`](https://curl.se), puoi utilizzare la tua chiave API ad esempio in questo modo:

```bash
export AISH_API_KEY="sk_..."

curl -X 'GET' 'https://api.aish.li/v1/ai/agents?limit=3' \
  -H "X-API-Key: $AISH_API_KEY" \
  | jq .
```

Un comando simile viene mostrato anche dopo aver fatto clic su _Try it out_ ed _Execute_ nel [Riferimento API](/docs/api).

Tieni presente che questa intestazione `X-API-Key` è diversa dall'intestazione `Authorization: Bearer ...`, che viene utilizzata solo per l'autenticazione con token OAuth2 nella documentazione interattiva dell'API. L'intestazione `X-API-Key` viene utilizzata invece di OAuth2 per l'autenticazione tramite chiave API dai tuoi sistemi backend.

> [!CAUTION]
> Le tue chiavi API sono riservate e concedono l'accesso completo al tuo account senza richiedere la password di accesso, inclusi i tuoi agenti, la cronologia delle sessioni e le impostazioni.
>
> - Non condividere mai pubblicamente la tua chiave API né eseguirne il commit nei repository Git.
> - Non incorporare mai chiavi API in codice HTML o JavaScript lato client.
> - Se ritieni che una chiave sia stata compromessa, revocala immediatamente utilizzando l'icona del cestino nella pagina [Chiavi API](/keys/api).

Le chiavi API vengono mostrate solo una volta al momento della creazione. Se perdi una chiave, dovrai generarne una nuova.