Skip to content

Intégration API REST

15 endpoints publics avec auth par clé API. Compatible avec tout langage backend ou plateforme. Spec OpenAPI 3.1 incluse.

Construisez votre propre intégration

Si nous n'avons pas de module natif pour votre plateforme, l'API REST couvre tous les cas d'usage.

15 endpoints

CRUD d'index, CRUD de documents (unitaire + bulk), recherche, multi-search, analytique et gestion des clés API.

OpenAPI 3.1

Spec lisible par machine sur /api/v1/openapi.json. Générez un client en Python, Go, Ruby ou n'importe quel autre langage.

Auth Bearer token

Clés API préfixées ss_search_*, ss_connector_*, ou ss_scoped_*. Chaque préfixe porte des permissions différentes.

Webhooks sortants (bientôt)

Recevez un webhook à la fin d'une sync, alerte de quota ou reindex terminé. Actuellement : API Connector pour le polling.

Headers de rate limit

Headers X-RateLimit-Limit et X-RateLimit-Remaining sur chaque réponse. Retry-After sur les 429.

API versionnée

Tous les endpoints publics sont sous /api/v1. Les breaking changes reçoivent un nouveau préfixe de version. Les anciennes versions sont conservées 12 mois.

Démarrer en 3 étapes

Intégrez AACsearch dans n'importe quel backend avec notre API REST.

  1. 1

    Étape 1

    Créer une clé API

    Créez une clé API dans le tableau de bord AACsearch. Allez dans Paramètres → Clés API → Créer une clé.

  2. 2

    Étape 2

    Authentifier vos requêtes

    Utilisez l'authentification par Bearer token. curl -H "Authorization: Bearer ss_search_..." \ https://api.aacsearch.com/v1/indexes/my-index/search

  3. 3

    Étape 3

    Faire votre première requête

    Appelez l'endpoint de recherche. curl -X POST https://api.aacsearch.com/v1/indexes/my-index/search \ -H "Authorization: Bearer ss_search_..." \ -H "Content-Type: application/json" \ -d {"q": "running shoes", "limit": 10}

Questions fréquentes

Lancez le Search OS en une soirée

Créez un index, ajoutez des documents et connectez la recherche depuis votre app. Le plan gratuit couvre un prototype — les données persistent lors du passage au plan payant.