Biblioteca de recursos
Cada proyecto tiene una biblioteca de medios. Un archivo se sube una vez y recibe un id estable, y el campo de imagen, vídeo o archivo de cualquier registro lo referencia por ese id.
Cómo funciona una subida
Una subida tiene tres pasos. createFileUpload devuelve una URL de subida válida durante una hora, el cliente envía los bytes directamente al almacenamiento y una llamada de confirmación devuelve el archivo. Los bytes nunca pasan por el endpoint de GraphQL. Esta vía no tiene límite de tamaño por archivo, y la comprobación al confirmar se hace contra tu cuota de almacenamiento. Una subida REST de una sola llamada admite archivos pequeños, de hasta 10 MB.
El navegador de un usuario con sesión iniciada puede ejecutar toda la subida con una clave pública y el token propio de ese usuario. El archivo es entonces suyo y privado de forma predeterminada.
Qué se lee de una imagen
Para JPEG, PNG, WebP y GIF, Fóir extrae el ancho, el alto, un marcador blurhash y un color dominante cuando se confirma la subida. Un campo de imagen devuelve los cuatro junto a la URL. Otros tamaños y formatos provienen de las transformaciones de imagen.
Carpetas, texto alternativo y la CLI
Un archivo puede estar en una carpeta y llevar texto alternativo, y la API pública devuelve ambos con el archivo. Desde una terminal, foir media sube, lista, actualiza, elimina y restaura archivos.
Eliminar y restaurar
Una eliminación es lógica, y una restauración la deshace. Quitar el objeto almacenado es una eliminación aparte, permanente. Eliminar requiere el files:delete alcance, que el acceso de escritura a archivos no implica.
Qué se rechaza
Se rechazan las subidas de HTML, JavaScript y XML. SVG se acepta, y uno abierto directamente se sirve como descarga bajo una política que bloquea los scripts.
Lee el detalle
La guía de medios cubre las subidas, la visibilidad, los comandos de la CLI, los recortes y el vídeo.