Rutas y enlaces profundos de Website
Dirige a los clientes a la experiencia pertinente de Website usando el mismo origen y los enlaces canónicos que genera su proyecto. La disponibilidad de una ruta también depende de la ubicación, cuenta y carrito del cliente, la configuración del proyecto y el modo de Website.
Rutas de inicio y descubrimiento
| Destino | Ruta | Requisitos y comportamiento |
|---|---|---|
| Inicio de Website | / o /home | Website puede mostrar Home, solicitar una ubicación para pedidos o redirigir a un negocio configurado. |
| Negocios disponibles | /search | Requiere una ubicación resuelta, salvo que la experiencia del proyecto proporcione un contexto de ubicación compatible. |
| Búsqueda de negocios y productos | /business_search | Requiere una ubicación. Los controles propios de Website pueden añadir texto de búsqueda y presentación de mapa. |
| Promociones | /promotions | Requiere una ubicación y no está disponible en modo kiosco. |
Completar de antemano la ubicación de descubrimiento
Las rutas de descubrimiento aceptan coordenadas finitas y distintas de cero mediante lat y lng. Se puede incluir un order_type numérico compatible cuando el cliente aún no tiene contexto de pedido.
https://shop.example.com/search?lat=25.7617&lng=-80.1918&order_type=1
Después de que Website aplica el contexto, quita los parámetros de ubicación de la URL visible. No consideres que las coordenadas de un enlace son una dirección guardada del cliente.
Enlaces a negocios y productos
Los proyectos pueden configurar plantillas canónicas de URL para negocios y productos. Las formas predeterminadas son:
/store/{businessSlug}
/store/{businessSlug}?category={categoryId}&product={productId}
Las instalaciones compatibles también pueden usar rutas basadas en slugs, como:
/{businessSlug}
/store/{businessSlug}/{categorySlug}/{productSlug}
/{businessSlug}/{categorySlug}/{productSlug}
Siempre copia o genera el enlace canónico desde el proyecto actual. No conviertas una URL basada en ID a otra basada en slugs salvo que Website del proyecto ya use esa plantilla.
Contexto de mesa
Un enlace de negocio puede incluir table_number para un flujo de consumo en el local compatible. Website guarda ese valor para el negocio seleccionado y lo usa cuando el tipo de pedido configurado requiere un lugar o una mesa. Añádelo únicamente cuando el negocio lo proporcione como parte de su propio flujo de enlace de mesa o código QR.
Destinos de cuenta y pedidos
| Destino | Ruta | Límite de acceso |
|---|---|---|
| Perfil | /profile | Cliente con sesión iniciada. |
| Historial de pedidos | /profile/orders | Cliente con sesión iniciada. |
| Direcciones guardadas | /profile/addresses | Cliente con sesión iniciada. |
| Tarjetas guardadas | /profile/cards | Cliente con sesión iniciada y configuración de pago compatible. |
| Wallets | /wallets | Cliente con sesión iniciada y experiencia Wallet habilitada; no disponible en modo kiosco. |
| Sesiones | /sessions | Cliente con sesión iniciada; no disponible en modo kiosco. |
| Mensajes | /messages | Cliente con sesión iniciada. |
| Detalles del pedido | /orders/{orderId} | Cliente con sesión iniciada o enlace completo de acceso temporal generado por Ordering. |
| Detalles de varios pedidos | /multi-orders/{orderId} | Cliente con sesión iniciada. |
No construyas parámetros temporales de acceso a pedidos. Conserva el enlace completo que genera Ordering y no registres ni expongas sus valores de consulta.
Destinos del carrito y checkout
| Destino | Ruta | Límite de acceso |
|---|---|---|
| Checkout | /checkout/{cartUuid} | Cliente con sesión iniciada y acceso al carrito. |
| Checkout de varios negocios | /multi-checkout/{cartUuid} | Cliente con sesión iniciada y carritos aptos. |
Website redirige a la experiencia de inicio configurada a los clientes que no pueden acceder a estos destinos. Una ruta por sí sola no concede acceso a un carrito o pedido.
/multi-cart es una transición automática interna que Website usa después de una acción compatible con carritos agrupados. No es un enlace profundo compatible para clientes y no se debe abrir directamente.
Contenido del proyecto e incorporación
| Destino | Ruta | Disponibilidad |
|---|---|---|
| Índice de páginas de contenido | /pages | Configuración de contenido del proyecto. |
| Página de contenido | /pages/{pageSlug} | Página habilitada con el slug solicitado. |
| Ayuda | /help | Cliente con sesión iniciada. |
| Solicitud para negocio | /signup_business | Experiencia de marketplace sin sesión y fuera del modo kiosco. |
| Solicitud para conductor | /signup-driver | Experiencia sin sesión y fuera del modo kiosco. |
| Restablecer contraseña | /password/reset | Experiencia sin sesión y fuera del modo kiosco. |
Reglas para gestionar enlaces
- Mantén todos los enlaces en el origen actual de Website del proyecto.
- Da preferencia al enlace canónico generado por Website frente a una ruta construida manualmente.
- Codifica por separado los valores de ruta y los valores de consulta.
- No incluyas contraseñas, claves de API, datos de pago, tokens de sesión ni tokens de integración en los ejemplos.
- La finalización del perfil requerido se aplica globalmente, salvo a los prefijos de checkout y pedidos y en modo kiosco; la verificación y el inicio de sesión dependen de cada ruta. Sigue la redirección o pantalla que devuelva Website en ese momento en vez de suponer que todos los destinos aplican esos controles en el mismo orden.
- No uses una dirección supuesta para probar si existe una ruta. Las direcciones de uno a tres segmentos pueden interpretarse como enlaces a negocios o productos, y las que empiezan con checkout pueden permanecer en el enrutamiento de checkout. Usa un enlace canónico de Website. El estado global Page Not Found solo se aplica cuando ningún patrón de ruta anterior coincide.
Referencias relacionadas: Experiencia y configuración de Website · Integraciones y transferencias externas de Website