Saltar al contenido principal
Cuando cambias la ruta de un archivo en tu carpeta de docs, también cambia la URL de esa página. Esto puede ocurrir al reestructurar tus docs o al cambiar el título de la barra lateral.

​
Redirecciones

Las fuentes de redirección no pueden incluir anclas de URL como path#anchor ni parámetros de consulta como path?query=value. Los destinos sí pueden incluir anclas (por ejemplo, /destination/path#section).
Añade el campo redirects al nivel superior de tu archivo docs.json para configurar redirecciones.
docs.json
Esto redirige /source/path a /destination/path. De forma predeterminada, las redirecciones son permanentes (308). Para usar una redirección temporal (307), establece permanent en false.
Tanto 307 como 308 conservan el método HTTP de la solicitud original (a diferencia de 301 y 302), por lo que son adecuados para redirigir solicitudes POST. Usa una redirección permanente (308) cuando una página se haya movido de forma definitiva: para slugs renombrados, navegación reestructurada o páginas eliminadas que se asignan a un reemplazo. Los motores de búsqueda transfieren el ranking SEO al destino y los navegadores almacenan la redirección en caché. Usa una redirección temporal (307) para redireccionamientos a corto plazo en los que la URL de origen volverá a estar disponible, como páginas de mantenimiento, pruebas A/B o enlaces de campañas que planeas reutilizar. Los motores de búsqueda mantienen la URL de origen en su índice y no transfieren el ranking.

​
Límites de redirecciones

No hay un límite estricto para el número de redirecciones que puedes definir en docs.json. Los arrays de redirecciones muy grandes (miles de entradas) pueden ralentizar los despliegues y dificultar la revisión del archivo, por lo que conviene consolidarlos con redirecciones con comodines siempre que sea posible.

​
Redirecciones con comodín

Para hacer coincidir una ruta con comodín, usa * después de un parámetro. En este ejemplo, /beta/:slug* coincide con /beta/introduction y la redirige a /v2/introduction.

​
Redirecciones con comodín parcial

Usa comodines parciales para hacer coincidir los segmentos de la URL que comienzan con un prefijo específico.
Esto coincide con cualquier URL con la ruta /articles/concepts-, como /articles/concepts-getting-started y /articles/concepts-overview, y las redirige todas a /collections/overview. También puedes usar el valor del comodín capturado en el destino.
Esto redirige /old/article-123 a /new/article-123, manteniendo el valor capturado después del prefijo.

​
Cómo coinciden las redirecciones

Cuando una solicitud coincide con más de una redirección, Mintlify elige una en este orden:
  1. Coincidencias exactas de source.
  2. Coincidencias de comodín parcial.
  3. Otras coincidencias de comodín.
Dentro de cada paso, gana la primera entrada coincidente del array redirects, así que coloca los orígenes más específicos antes que los más generales. Los orígenes con comodines tienen estas limitaciones:
  • Cada origen solo puede contener un comodín. Mintlify omite los orígenes con más de un comodín, como /:version*/guides/:slug*.
  • Un comodín parcial coincide dentro de un solo segmento de la ruta. /old/article-* coincide con /old/article-123, pero no con /old/article-123/details.
  • Los orígenes no admiten expresiones regulares. * es el único carácter comodín, y los demás caracteres coinciden literalmente.

​
Evita redirecciones infinitas

Para evitar bucles infinitos, no crees redirecciones circulares en las que las rutas se redirijan unas a otras.

​
Cuándo surten efecto las redirecciones

Las redirecciones en docs.json se aplican en el momento de la solicitud en la capa de hosting de Mintlify, por lo que entran en vigor en cuanto tus cambios se despliegan. Los despliegues de vista previa también aplican las redirecciones, lo que te permite verificar el comportamiento antes de hacer merge a tu rama de producción. Para probar las redirecciones de forma local, ejecuta mint dev y visita la ruta de origen en tu navegador. El servidor de desarrollo local aplica las redirecciones definidas en tu docs.json. Detecta enlaces rotos con la CLI.