Saltar al contenido principal

API · Visión general

Como integrador llamas una sola API: la External Integrations API (/api/integrations/v1/*) desde tu servidor. Toda la referencia de este sitio se genera directamente desde la spec OpenAPI 3.1 que el backend publica en cada release. Si algo aparece aquí, existe en producción; si no aparece, no existe.

External Integrations API​

PrefijoAuthQuién lo usa
/api/integrations/v1/*Authorization: Bearer <api-key>Tu servidor (cualquier stack: Node, Python, Java, .NET, PHP, Ruby, Go)

Cubre todos los flujos server-to-server: consulta y sync del catálogo, tracking de conversiones. El playground "Try It" está en Referencia (Try it) (columna izquierda).

El widget embebido en el navegador habla con su propio backend interno. Tú no llamas a esos endpoints — el bundle del widget (cdn.neuroon.ai/widget.js) los consume directamente con un Widget Token que firma tu propio servidor localmente con la API Key (HMAC). Ver Authentication · Widget Token.

Convenciones globales​

  • Formato: JSON UTF-8. Content-Type: application/json.
  • Idiomas: el backend acepta Accept-Language y devuelve textos generados en uno de los 9 idiomas soportados si encaja; cae a es por defecto.
  • Errores: estructura uniforme. Ver Reference · Errores.
  • Rate limits: basados en el plan de suscripción. Headers X-RateLimit-* en cada respuesta.
  • Latencia de indexación: 2-5 segundos tras 200 OK en /products/sync (eventual consistency).

Los detalles operativos (URLs base por entorno, headers obligatorios, idempotencia) están en Convenciones de la API.

Cómo usar el playground​

Las páginas de Reference embeben un explorador interactivo. Para probar:

  1. Selecciona el entorno (Production o Development) con el selector del navbar.
  2. Pega tu API Key en el campo de autenticación (Bearer).
  3. Rellena los path/query/body parameters y pulsa Send API Request. La respuesta llega con headers y body reales.

Próximas lecturas​

Última actualización en