data/prices.json devuelve 404 cuando solicitas https://docs.example.com/data/prices.json, revisa las causas siguientes. Para una visión general de cómo funciona el servicio de archivos estáticos y la lista de tipos de archivo compatibles, consulta Archivos.
Confirma que la URL coincide con la ruta del repositorio
La ruta de la URL refleja la ubicación del archivo en tu repositorio. Un archivo confirmado en la raíz del repositorio comoprices.json se sirve en https://docs.example.com/prices.json. Un archivo en data/prices.json se sirve en https://docs.example.com/data/prices.json.
Errores comunes:
- Diferencia de mayúsculas.
Prices.jsonyprices.jsonson URLs distintas. - El archivo solo está en una rama de funcionalidad. Solo se sirven los archivos confirmados en la rama que Mintlify construye.
- Un error tipográfico en la extensión. Mintlify sirve el archivo con el nombre exacto que tiene en el repositorio.
Comprueba que el tipo de archivo es compatible
Mintlify solo sirve los tipos de archivo listados en Tipos de archivo compatibles. Algunos tipos, como.pdf, .txt, .xml, .csv y .zip, solo se sirven en planes Enterprise. Un archivo con una extensión no compatible devuelve 404 aunque exista en el repositorio.
Comprueba el tamaño del archivo
Los archivos deben ser menores de 20 MB. Los archivos más grandes no se sirven y deben alojarse en una CDN externa o en un almacén de objetos.Descarta la autenticación
El servicio de archivos estáticos no está disponible para sitios de documentación con autenticación habilitada. Las URLs directas a archivos devuelven404 en sitios autenticados incluso cuando el archivo existe y el usuario ha iniciado sesión. Aloja el archivo en un servicio externo si tu sitio requiere autenticación.
Descarta .mintignore y otras exclusiones
Comprueba si el archivo coincide con un patrón en .mintignore. Mintlify no publica archivos que coincidan con patrones de .mintignore, por lo que no estarán disponibles en su URL. Consulta Excluir archivos de la publicación.
Mintlify también ignora automáticamente directorios como node_modules, build, dist y .git. Un archivo dentro de uno de esos directorios no se sirve. Mueve el archivo a un directorio que no se ignore automáticamente, como assets/ o data/. Consulta la lista completa de directorios ignorados por defecto en Patrones ignorados por defecto.