Autenticación

Base URLs

Usá la base correspondiente a tu entorno:

Pruebas:    https://api.test-ninox.com.ar
Producción: https://api.ninox.com.ar

Todos los endpoints de esta documentación son relativos a esa base.

Desarrollá y validá siempre contra pruebas (api.test-ninox.com.ar). El pasaje a producción (api.ninox.com.ar) es el último paso del onboarding.

Token

Todas las requests deben incluir el token en el header X-NX-TOKEN:

X-NX-TOKEN: tu_token
Content-Type: application/json

El token se provisiona como parte del onboarding y está asociado a un único depósito y punto de venta (ver Alcance y límites).

Seguridad

No expongas el token en frontend ni en aplicaciones cliente. El token da acceso a los datos de la cuenta: implementá la integración del lado servidor o en una capa backend intermedia que guarde el token y exponga solo lo que tu app necesite.

Primer request recomendado

El punto de partida es obtener el catálogo completo:

curl --request GET \
  --url https://api.test-ninox.com.ar/integraciones/Terceros/GetData \
  --header 'X-NX-TOKEN: {TU_TOKEN}' \
  --header 'content-type: application/json'

GET/integraciones/Terceros/GetData

La respuesta es un Articulo[]. El detalle de tipos está en Esquema de datos y el uso del catálogo en Catálogo.

Frecuencia de consulta

GetData y GetDataCurva tienen una frecuencia mínima de 10 minutos entre consultas consecutivas. Si consultás antes, la API puede responder 403 Forbidden. Ver Alcance y límites.

Errores de autenticación

Código	Descripción	Qué revisar
401	Token inválido o expirado	Header X-NX-TOKEN
403	Consulta fuera de la frecuencia permitida	Esperar la ventana mínima

La tabla completa está en Errores comunes.