Clés API

Pour utiliser notre API, vous devez générer une clé API.

Une fois votre clé obtenue, vous pouvez l'utiliser pour authentifier vos requêtes auprès de notre API.

Avec `curl`, vous pouvez par exemple utiliser votre clé API de la façon suivante :

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 .

Une commande similaire s'affiche également après avoir cliqué sur Try it out et Execute dans la Référence API.

Notez que cet en-tête X-API-Key est différent de l'en-tête Authorization: Bearer ..., qui est utilisé uniquement pour l'authentification par jeton OAuth2 dans la documentation interactive de l'API. L'en-tête X-API-Key est utilisé à la place d'OAuth2 pour l'authentification par clé API depuis vos propres systèmes backend.

Caution

Vos clés API sont sensibles et accordent un accès complet à votre compte sans nécessiter votre mot de passe de connexion — y compris à vos agents, à votre historique de sessions et à vos paramètres.

  • Ne partagez jamais votre clé API publiquement et ne la validez jamais dans des dépôts Git.
  • N'intégrez jamais de clés API dans du code HTML ou JavaScript côté client.
  • Si vous pensez qu'une clé a été compromise, révoquez-la immédiatement à l'aide de l'icône de corbeille sur la page Clés API.

Les clés API ne sont affichées qu'une seule fois lors de leur création. Vous devrez en générer une nouvelle si vous la perdez.