Saltar al contenido principal

Ejemplos en GitHub

Tenemos un repositorio público con templates, ejemplos y documentación para arrancar una integración con NinoxNet en minutos. Está en TypeScript y pensado para que también agentes AI (Claude, Cursor, Codex, etc.) lo clonen y generen tu app.

REPOgithub.com/banhaia/ninox-integration-starters

👉 github.com/banhaia/ninox-integration-starters

Qué incluye​

RecursoPara qué sirve
templates/node-typescript/Cliente HTTP base, tipos y normalización
examples/chatbot-stock/Búsqueda de productos por texto para bots
examples/ecommerce-sync/Mapeo de catálogo para storefronts
examples/create-order/Payload base de creación de pedido
examples/stock-dashboard-app/App full-stack de referencia (React + Vite + Tailwind + Express)
shared/sample-responses/Respuestas mock para desarrollar sin token
shared/postman/Colección + entorno Postman para testing manual
Desarrollá sin token

El repo incluye respuestas de ejemplo en shared/sample-responses/, así podés arrancar offline antes de tener tu X-NX-TOKEN.

Uso rápido​

git clone https://github.com/banhaia/ninox-integration-starters.git
cd ninox-integration-starters
npm install

# Configurá tu token y base URL
cp templates/node-typescript/.env.example templates/node-typescript/.env
# Editá .env con NINOX_BASE_URL y NINOX_TOKEN

# Probá una búsqueda de stock por texto
node examples/chatbot-stock/run.js "remera"

Para correr la app full-stack de referencia:

cp examples/stock-dashboard-app/.env.example examples/stock-dashboard-app/.env
npm run dev      # dentro de examples/stock-dashboard-app
npm run build

Usar con un agente AI​

El starter kit está preparado para funcionar con agentes AI. Incluye un archivo CLAUDE.md (y AGENTS.md) en la raíz con instrucciones que los agentes leen automáticamente.

  1. Cloná el repositorio.
  2. Abrilo en tu herramienta preferida (Claude Code, Claude Cowork, Cursor, etc.).
  3. Pedile al agente algo como:

"Quiero crear una integración con Ninox. Mi caso de uso es ecommerce. Mi stack es React + Express. Tengo token."

"Quiero crear una integración con Ninox. Mi caso de uso es chatbot. Elegí el mejor stack para mí. No tengo token."

El agente sigue la metodología de 5 pasos del asistente de implementación, usa el repo como referencia de patrones y crea tu app en un directorio nuevo.

No es obligatorio usar Node.js

Los ejemplos están en Node.js/TypeScript, pero la API de NinoxNet es REST estándar. Un agente AI puede generar código en cualquier lenguaje usando los ejemplos como referencia de patrones y el CLAUDE.md como guía.

Si no usás un agente AI​

Podés copiar los prompts sugeridos del archivo data/ninox_getting_started_integracion_terceros.md del repo y pegarlos en cualquier chat de AI (ChatGPT, Claude, etc.) para que te ayude con la implementación.

Siguiente paso​