API de Neuroon

La API REST de Neuroon te permite integrar búsqueda semántica en cualquier aplicación.

Base URL

https://api.neuroon.ai/api

Autenticación

Todas las peticiones requieren autenticación mediante token:

curl -X GET https://api.neuroon.ai/api/search \
  -H "X-Widget-Token: YOUR_TOKEN"

Ver Autenticación para más detalles.

Formato de respuesta

Todas las respuestas son JSON:

{
  "data": { ... },
  "meta": {
    "queryTimeMs": 45
  }
}

Errores

{
  "error": {
    "code": "INVALID_TOKEN",
    "message": "Token inválido o expirado"
  }
}

Códigos de estado

Código	Descripción
200	Éxito
400	Petición inválida
401	No autenticado
403	No autorizado
404	No encontrado
429	Rate limit excedido
500	Error del servidor

Endpoints principales

Endpoint	Método	Descripción
/search	POST	Búsqueda semántica
/suggestions	GET	Autocompletado
/products	GET	Listar productos
/products/sync	POST	Sincronizar productos

SDKs

• JavaScript: @neuroon/widget (incluye cliente API)
• PHP: Próximamente
• Python: Próximamente

Límites

Ver Rate Limits para información sobre límites de uso.