Versiones

Versión actual

API	v1
Documentación	1.1.0, del 01/10/2026

La versión de la API va en la dirección de todas las rutas:

https://<dominio-de-la-empresa>/api/v1/ecommerce

Cómo se versiona

La API cambia de versión solo cuando un cambio puede romper una integración que ya funciona:

• quitar o renombrar una ruta o un campo;
• cambiar el tipo de un campo o lo que significa;
• volver obligatorio un dato que era opcional;
• cambiar un code de error.

Ese cambio iría en una dirección nueva (/api/v2/ecommerce). La versión anterior seguiría funcionando durante un tiempo, que se anunciará aquí.

Dentro de la v1 solo entran cambios que no rompen nada: rutas nuevas, campos nuevos en las respuestas, parámetros opcionales nuevos y códigos de error nuevos. Programa tu integración para ignorar los campos que no conoce.

La documentación sigue el formato mayor.menor.corrección:

Parte	Cuándo sube
Mayor	Una versión nueva de la API
Menor	Rutas, campos o parámetros nuevos
Corrección	Aclaraciones y errores de la documentación, sin cambios en la API

Historial

1.1.0 · 01/10/2026

• Nuevo: MCP de Geor. Conecta tu IA (Claude, ChatGPT, Cursor o VS Code) y consultará esta documentación sola mientras construye tu tienda: búsqueda, documentos completos, el detalle de cada ruta, una guía para crear la tienda y una tienda de referencia.
• La API no cambia: sigue en la v1.

1.0.0 · 29/09/2026

Primera versión publicada de la API v1:

• Catálogo sin token: productos con sus filtros, ficha, variantes, productos relacionados, categorías, banners y atributos.
• Tienda: ajustes, países e idiomas, establecimientos, envío de un producto, libro de reclamaciones, tipos de envío, textos legales, cupones disponibles, métodos de pago y agencias de transporte.
• Cuenta: registro, inicio y cierre de sesión, perfil y contraseña, verificación, recuperación de la contraseña, cambio de email o teléfono y baja de la cuenta.
• Compra: carrito, cálculo del envío y de cupones, confirmación del pedido, historial, detalle y anulación.
• Datos del comprador: direcciones, facturación, destinatarios, tarjetas y favoritos.
• Errores con un code estable para cada caso y límites de peticiones por minuto.