Chiavi API

Per utilizzare la nostra API, devi generare una chiave API.

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

Con `curl`, puoi utilizzare la tua chiave API ad esempio in questo modo:

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.

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.

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