Skip to content

Integración con la API REST

15 endpoints públicos con autenticación por clave API. Compatible con cualquier lenguaje o plataforma backend. Especificación OpenAPI 3.1 incluida.

Construye tu propia integración

Si no disponemos de un módulo nativo para tu plataforma, la API REST cubre todos los casos de uso.

15 endpoints

CRUD de índices, CRUD de documentos (individual + masivo), búsqueda, multi-search, analíticas y gestión de claves API.

OpenAPI 3.1

Especificación legible por máquina en /api/v1/openapi.json. Genera un cliente en Python, Go, Ruby o cualquier otro lenguaje.

Auth con Bearer token

Claves API con prefijos ss_search_*, ss_connector_* o ss_scoped_*. Cada prefijo tiene permisos distintos.

Webhooks de salida (próximamente)

Recibe un webhook al completar una sincronización, alerta de cuota o reindexación finalizada. Actualmente: API de conector para polling.

Encabezados de rate limit

Encabezados X-RateLimit-Limit y X-RateLimit-Remaining en cada respuesta. Retry-After en los 429.

API versionada

Todos los endpoints públicos están bajo /api/v1. Los cambios incompatibles reciben un nuevo prefijo de versión. Las versiones anteriores se mantienen durante 12 meses.

Comenzar en 3 pasos

Integra AACsearch en cualquier backend con nuestra API REST.

  1. 1

    Paso 1

    Crea una clave API

    Crea una clave API en el panel de AACsearch. Ve a Configuración → Claves API → Crear clave.

  2. 2

    Paso 2

    Autentica tus solicitudes

    Usa autenticación Bearer token. curl -H "Authorization: Bearer ss_search_..." \ https://api.aacsearch.com/v1/indexes/my-index/search

  3. 3

    Paso 3

    Haz tu primera solicitud

    Llama al endpoint de búsqueda. 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}

Preguntas frecuentes

Lanza el Search OS en una tarde

Crea un índice, añade documentos y conecta la búsqueda desde tu app. El plan gratuito cubre un prototipo — los datos se mantienen al actualizar.