Docs / Démarrage rapide

Démarrage rapide

De l'inscription à votre premier appel API en 5 minutes.

1. Créer un compte

  1. Rendez-vous sur la page d'inscription et créez un compte
  2. Vérifiez votre adresse e-mail en cliquant sur le lien envoyé dans votre boîte de réception
  3. Connectez-vous à votre nouveau compte

2. Créer une collection

  1. Cliquez sur Collections dans la barre latérale
  2. Cliquez sur Nouvelle collection
  3. Donnez-lui un nom, par exemple Mes Documents

3. Télécharger un document

  1. Ouvrez votre collection
  2. Cliquez sur Télécharger un document
  3. Choisissez un PDF, un document Word, un fichier Markdown, un tableur, un fichier texte ou collez du texte brut. Vous pouvez sélectionner plusieurs fichiers à la fois.
  4. Attendez le traitement — le statut passe de En attente → Traitement → Indexé

Vous pouvez aussi télécharger des documents via l'API. Consultez la Référence API pour plus de détails.

curl -X POST https://YOUR_INSTANCE/api/v1/collections/{uuid}/documents/ \
  -H "Authorization: Bearer aqn_YOUR_API_KEY" \
  -F "file=@document.pdf"

4. Connecter Claude

Claude Desktop : Allez dans Personnaliser → Connecteurs → cliquez sur + → Ajouter un connecteur personnalisé → entrez le nom aqoon et l'URL https://aqoon.ai/mcp/ → cliquez sur Connecter → connectez-vous et approuvez. C'est fait !

Claude Code : Vous aurez besoin d'une clé API (voir l'étape suivante).

5. Obtenir une clé API (Claude Code / API)

  1. Allez dans Clés API
  2. Cliquez sur Créer une nouvelle clé
  3. Choisissez Accès complet pour les tests
  4. Copiez la clé immédiatement — elle commence par aqn_ et ne sera plus affichée

6. Faites votre premier appel API

cURL :

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

Python :

pip install aqoon
from aqoon import Aqoon

client = Aqoon(api_key="aqn_YOUR_API_KEY")
results = client.search("your search query")

for r in results["results"]:
    print(r["title"], r["score"])

Exemple JavaScript

npm install @54startups/aqoon
import { Aqoon } from '@54startups/aqoon';

const client = new Aqoon({ apiKey: 'aqn_YOUR_API_KEY' });
const results = await client.search('your search query');

results.results.forEach(r => console.log(r.title, r.score));

Consultez la page SDKs pour la documentation complète incluant le téléchargement de documents, la gestion des collections et la gestion des clés API.

7. Et ensuite ?