Modos de entrega del sitio web y API sin cabeza
Tu sitio web público puede provenir de la tienda integrada, de un frontend desplegado por separado (por ejemplo, una aplicación Next.js o una aplicación móvil), o de ambos. La elección se encuentra en una pantalla de administración y cambiarla no requiere un despliegue.
Dónde configurarlo
Constructor de sitios → Entrega del sitio web (/admin/storefront/headless). La pantalla muestra el modo actual, la dirección del frontend, una verificación de accesibilidad y la hora de la última actualización de caché enviada al frontend.
Los cinco modos
| Modo | Sitio web público | Cuándo usarlo |
|---|---|---|
| Solo sitio web integrado | Esta aplicación | La mayoría de las tiendas. Un servidor, nada extra que desplegar. |
| Frontend integrado y separado | Ambos | Estás probando un nuevo frontend mientras el sitio actual sigue vendiendo. Los correos electrónicos de los clientes enlazan al sitio que usó el cliente. |
| Páginas integradas, tienda en el frontend | Inicio, páginas y blog aquí; tienda, carrito, pago y cuenta en el frontend | Tu equipo de contenido mantiene el constructor de páginas mientras la tienda se mueve al frontend más rápido. |
| Solo frontend separado | El frontend | El frontend es todo el sitio público. Este host redirige a los visitantes allí y mantiene solo el panel de administración y la API, ocultos de los motores de búsqueda. |
| Sitio web apagado | Ninguno | Una oficina trasera sin catálogo, por ejemplo, un fabricante que solo ejecuta el ERP. |
Cada redirección, enlace generado y correo electrónico del cliente — restablecimiento de contraseña, verificación, pedidos, recuperación de carrito — sigue el modo que elijas.
La API de Storefront
- Dirección base:
/api/storefront/v1. Está cerrada hasta que elijas un modo que use un frontend. - Referencia:
/api/storefront/v1/docs(OpenAPI). Es visible para los administradores; puedes hacerlo público en la misma pantalla. - Cubre el sitio, tema, páginas, menús, encabezado y pie de página, formularios, catálogo, carrito, pago, inicio de sesión y el portal del cliente. Los módulos opcionales como blog, reseñas, reservas y lealtad solo responden cuando están instalados.
- Cada endpoint de lista está paginado (24 por página por defecto, hasta 60).
Cambiando a un frontend separado de manera segura
- Despliega el frontend y anota su dirección HTTPS.
- Elige Frontend integrado y separado primero, ingresa la dirección del frontend y guarda. Ambos sitios ahora funcionan.
- Prueba la navegación, carrito, pago e inicio de sesión en el frontend.
- Agrega redirecciones para cualquier enlace antiguo que cambie de forma, uno por línea.
- Solo entonces cambia a Frontend separado solamente o la división de páginas/tienda.
- Si usas Cloudflare, agrega el id de zona y un token de purga para que la caché del frontend se limpie después de cada cambio de contenido.
Última actualización: 11/7/2026