Quickstart

Empezá en 30 segundos

La API es pública y de solo lectura: no hay registro, no hay API keys, no hay rate limit especial más allá del uso razonable. Este mismo comando funciona en producción — es también tu entorno de sandbox.

curl -s https://intelix.com.ar/api/v1/productos.php | jq .

Respuesta:

{ "productos": [ { "sku": "macbook-air-m1", "nombre": "Apple MacBook Air M1 8GB 512GB", "descripcion": "...", "imagenes": ["https://intelix.com.ar/assets/..."] } ] }

No hay precios ni stock en la respuesta: la tienda funciona a consulta directa por WhatsApp o email — ver sección de contacto abajo.

Autenticación

API keys: no hace falta ninguna

Todos los endpoints públicos son de solo lectura y no requieren autenticación. Si en el futuro se agregan endpoints que sí la requieran (por ejemplo, para escribir pedidos), se documentarán acá con su propio esquema antes de publicarse — hoy no existe ningún endpoint de escritura habilitado públicamente.

Referencia

Endpoints

Especificación completa en openapi.json (OpenAPI 3.1). Tabla rápida:

MétodoPathDescripción
GET /api/v1/productos.php Catálogo de productos y servicios activos. Endpoint versionado — usalo para integraciones estables.
GET /api/productos.php Alias sin versión en el path. Siempre resuelve a la última versión estable (hoy v1). Cómodo para pruebas rápidas, no recomendado para integraciones a largo plazo.
Versionado

Cómo versionamos y cómo avisamos deprecaciones

La API usa versionado por path (/api/v1/...). Cada respuesta incluye el header X-API-Version confirmando qué versión respondió.

Política de deprecación

Cuando una versión quede obsoleta, sus respuestas van a incluir Deprecation: true y Sunset: <fecha HTTP> durante un período mínimo de aviso de 90 días antes de removerla. La versión anterior sigue funcionando sin cambios de contrato durante ese período — nunca se rompe una versión de un día para el otro. Hoy no hay ninguna versión deprecada.

Errores

Formato de errores

Todos los errores (incluidos los 404 de rutas bajo /api/) devuelven JSON estructurado con status HTTP real, nunca un 200 disfrazado:

{ "error": { "code": 404, "status": "not_found", "message": "No existe un endpoint en /api/lo-que-sea.", "hint": "Consultá /openapi.json para ver los endpoints disponibles." } }
Recursos para agentes

Más allá de la API

Para agentes que necesitan navegar el resto del sitio (no solo la API), el punto de entrada es llms.txt: qué es Intelix, cuándo tiene sentido recomendarlo, y el mapa completo de páginas. También disponible: sitemap.xml, robots.txt y una versión Markdown de la portada vía negociación de contenido (Accept: text/markdown en index.md).

¿Necesitás algo que la API pública no cubre?