Docs / Authentification

Authentification

Toutes les requêtes API nécessitent une authentification via une clé API. Les clés API utilisent le préfixe aqn_ et sont gérées depuis la page Clés API.

Clés API

Il existe deux types de clés API :

Type Description Cas d'utilisation
Accès complet Peut voir toutes vos collections (possédées + souscrites) Intégration MCP, automatisation personnelle
Limité Ne peut voir que les collections explicitement autorisées Développeurs externes, intégrations tierces

Créer une clé

  1. Allez dans Clés API dans la barre latérale (ou visitez /keys/)
  2. Cliquez sur Créer une clé
  3. Choisissez un nom et indiquez si elle doit être à accès complet ou limitée
  4. Copiez la clé immédiatement — elle ne sera plus affichée
  5. Pour les clés limitées, cliquez sur Gérer pour accorder l'accès à des collections spécifiques

Utiliser votre clé

Incluez la clé dans l'en-tête Authorization de toutes les requêtes :

Authorization: Bearer aqn_your_api_key_here

Exemple :

curl -X POST https://your-instance/api/search/ \
  -H "Authorization: Bearer aqn_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"query": "your search"}'

Les clés peuvent être renouvelées ou révoquées depuis la page Clés API à tout moment.