Desarrolladores

Una API para búsqueda, recomendaciones y respuestas.

El contrato OpenAPI se genera desde el enrutador en vivo, por lo que los documentos nunca describen un endpoint que no existe. Usa la API REST, el SDK de TypeScript o Python, o el widget embebible.

Leer los documentosObtener una clave API
Operaciones
176
Endpoints
147
OpenAPI
3.1.0
curl -X POST https://api.example.com/api/v1/indexes/products/search \
  -H "Authorization: Bearer $AAC_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "кросовки найк",
       "per_page": 20,
       "facet_by": "brand,size"}'

OpenAPI desde el enrutador

El contrato se genera desde el código que atiende las solicitudes y se verifica en CI, por lo que los documentos y SDKs no pueden desviarse de la API.

SDKs de TypeScript y Python

Clientes tipados generados desde el contrato, con reintentos en errores transitorios.

Claves con alcance

Las claves llevan alcances, pueden expirar y rotarse con un período de gracia; los navegadores obtienen tokens de sesión de 15 minutos en lugar de claves.

Webhooks firmados

Eventos para importaciones, ejecuciones de conectores y experimentos, firmados con HMAC y reintentados en una escalera de 1 min → 12 h.

Códigos de error estables

Cada error tiene un código público, un mensaje y un id de solicitud; los detalles internos nunca se filtran en las respuestas.

Límites predecibles

Límites de tasa por clave con encabezados estándar, y cuotas de plan que puedes leer a través de la API.

Siguiente: conecta tus datos o lee cómo otros equipos miden la búsqueda.

IntegracionesGuíasSeguridad