Ir al contenido
inicio / kit / files
FilesFILES

Cada archivo es una URL

Una interfaz HTTP para almacenamiento local y más de 60 proveedores en la nube: Google Drive, S3, Dropbox y más. Monta una vez, accede siempre.

hoody-files · acceso universal de almacenamiento

# Google Drive

$ curl /api/v1/files/Work/report.pdf \

?backend=backend_drive_abc

# Amazon S3

$ curl /api/v1/files/backups/data.zip \

?backend=backend_s3_xyz

# Dropbox

$ curl /api/v1/files/Photos/vacation.jpg \

?backend=backend_dropbox_123

# mismo patrón de URL

HTTP/1.1 200 OK

Content-Type: application/pdf

Content-Length: 524288

# almacenamiento diferente

HTTP/1.1 200 OK

Content-Type: application/zip

ETag: "a3f2bc..."

Mismo patrón de URL. Almacenamiento diferente. Sin complejidad.

inicio / kit / files / backends
MÁS DE 60 PROVEEDORES

Conecta cualquier almacenamiento al instante

Monta Google Drive, S3, Dropbox y más de 60 proveedores adicionales. Una autenticación por backend, luego accede a todo a través de una única interfaz HTTP.

Google Drive
Dropbox
OneDrive
Box
iCloud Drive
MEGA
Google Photos
Jottacloud
Koofr
Seafile
Proton Drive
pCloud
HiDrive
Mail.ru Cloud
Yandex Disk
Zoho WorkDrive
Citrix ShareFile
1Fichier
Files.com
PikPak
Pixeldrain
SugarSync
Put.io
Quatrix
OpenDrive
Gofile
Linkbox
Premiumize.me
Uptobox
Uloz.to
Enterprise File Fabric
Google Drive
Dropbox
OneDrive
Box
iCloud Drive
MEGA
Google Photos
Jottacloud
Koofr
Seafile
Proton Drive
pCloud
HiDrive
Mail.ru Cloud
Yandex Disk
Zoho WorkDrive
Citrix ShareFile
1Fichier
Files.com
PikPak
Pixeldrain
SugarSync
Put.io
Quatrix
OpenDrive
Gofile
Linkbox
Premiumize.me
Uptobox
Uloz.to
Enterprise File Fabric
Google Drive
Dropbox
OneDrive
Box
iCloud Drive
MEGA
Google Photos
Jottacloud
Koofr
Seafile
Proton Drive
pCloud
HiDrive
Mail.ru Cloud
Yandex Disk
Zoho WorkDrive
Citrix ShareFile
1Fichier
Files.com
PikPak
Pixeldrain
SugarSync
Put.io
Quatrix
OpenDrive
Gofile
Linkbox
Premiumize.me
Uptobox
Uloz.to
Enterprise File Fabric
Google Drive
Dropbox
OneDrive
Box
iCloud Drive
MEGA
Google Photos
Jottacloud
Koofr
Seafile
Proton Drive
pCloud
HiDrive
Mail.ru Cloud
Yandex Disk
Zoho WorkDrive
Citrix ShareFile
1Fichier
Files.com
PikPak
Pixeldrain
SugarSync
Put.io
Quatrix
OpenDrive
Gofile
Linkbox
Premiumize.me
Uptobox
Uloz.to
Enterprise File Fabric
Amazon S3
Azure Blob Storage
Azure Files
Google Cloud Storage
Backblaze B2
Cloudinary
ImageKit
Internet Archive
Akamai NetStorage
Oracle OCI
Wasabi
DigitalOcean Spaces
Cloudflare R2
Linode Object Storage
MinIO
Ceph
IBM COS
Alibaba OSS
Tencent COS
Huawei OBS
IDrive e2
IONOS Cloud
Scaleway
Storj DCS
Filebase
Rackspace Cloud Files
OpenStack Swift
NetApp StorageGRID
Dell EMC ECS
SeaweedFS
Garage
Amazon S3
Azure Blob Storage
Azure Files
Google Cloud Storage
Backblaze B2
Cloudinary
ImageKit
Internet Archive
Akamai NetStorage
Oracle OCI
Wasabi
DigitalOcean Spaces
Cloudflare R2
Linode Object Storage
MinIO
Ceph
IBM COS
Alibaba OSS
Tencent COS
Huawei OBS
IDrive e2
IONOS Cloud
Scaleway
Storj DCS
Filebase
Rackspace Cloud Files
OpenStack Swift
NetApp StorageGRID
Dell EMC ECS
SeaweedFS
Garage
Amazon S3
Azure Blob Storage
Azure Files
Google Cloud Storage
Backblaze B2
Cloudinary
ImageKit
Internet Archive
Akamai NetStorage
Oracle OCI
Wasabi
DigitalOcean Spaces
Cloudflare R2
Linode Object Storage
MinIO
Ceph
IBM COS
Alibaba OSS
Tencent COS
Huawei OBS
IDrive e2
IONOS Cloud
Scaleway
Storj DCS
Filebase
Rackspace Cloud Files
OpenStack Swift
NetApp StorageGRID
Dell EMC ECS
SeaweedFS
Garage
Amazon S3
Azure Blob Storage
Azure Files
Google Cloud Storage
Backblaze B2
Cloudinary
ImageKit
Internet Archive
Akamai NetStorage
Oracle OCI
Wasabi
DigitalOcean Spaces
Cloudflare R2
Linode Object Storage
MinIO
Ceph
IBM COS
Alibaba OSS
Tencent COS
Huawei OBS
IDrive e2
IONOS Cloud
Scaleway
Storj DCS
Filebase
Rackspace Cloud Files
OpenStack Swift
NetApp StorageGRID
Dell EMC ECS
SeaweedFS
Garage
inicio / kit / files / protocols
PROTOCOLOS DE ARCHIVOS

Compatible con todos los protocolos de almacenamiento

FTP, SFTP, SMB, WebDAV, HTTP y HDFS: monta almacenamiento en red usando el protocolo que ya habla tu infraestructura.

FTPpuerto 21
SFTPpuerto 22
SMBpuerto 445
WebDAVNextcloud / SharePoint
HTTPservidores de archivos web
HDFSclústeres Hadoop
inicio / kit / files / capabilities
CAPACIDADES

Más que almacenamiento de archivos

Transmite, verifica hashes, previsualiza, comprime, registra y procesa imágenes: todo a través de una única interfaz HTTP que funciona en todos los backends.

Leer y transmitir

Transmite cualquier archivo vía HTTP desde almacenamiento local o cualquier backend en la nube montado. Compatible con formatos de respuesta HTML, JSON y texto plano.

GET /api/v1/files/[path]

Integridad SHA256

Calcula hashes SHA256 o MD5 sin descargar el archivo completo. Esencial para despliegues en producción, verificación de copias de seguridad y cumplimiento normativo.

GET /api/v1/files/[path]?hash

Vista previa de archivos comprimidos

Inspecciona contenidos de .tar.gz y .zip sin extraer el archivo. Lista entradas, tamaños y rutas al instante.

GET /[path]?preview

Directorio como .zip

Descarga cualquier directorio como un archivo .zip bajo demanda. Funciona tanto para almacenamiento local como para backends remotos en la nube.

GET /[path]?zip

Journal e historial de archivos

Cada mutación se registra con un snapshot de blob con dirección de contenido. Lee cualquier archivo en cualquier revisión o marca de tiempo pasada y compara versiones.

GET /api/v1/files/[path]?history

Procesamiento de imágenes

Redimensionado al vuelo, conversión de formato, desenfoque y escala de grises para JPEG, PNG, WebP, GIF y BMP desde cualquier backend de almacenamiento.

GET /[image]?thumbnail&width=400
inicio / kit / files / api
REFERENCIA DE API

21 endpoints. Una interfaz.

Lee, escribe, gestiona backends y monitoriza el journal: todo expuesto como HTTP plano. Sin SDK requerido.

Leer y descargar

[count, plural, =1 [# endpoint] other [# endpoints]]'

curl .../api/v1/files/Work/report.pdf?backend=backend_drive

GET
/api/v1/files/[path]Leer o descargar contenido de un archivo
GET
/[path]Alternativa con formatos HTML/JSON/simple
HEAD
/api/v1/files/[path]Obtener metadatos sin descargar
GET
/api/v1/files/[path]?hashObtener hash SHA256 del archivo
GET
/[path]?previewVista previa del contenido del archivo comprimido (tar.gz, zip)
GET
/[path]?zipDescargar directorio como archivo .zip

Escribir y mutar

[count, plural, =1 [# endpoint] other [# endpoints]]'

POST .../api/v1/files/copy/[path]?copy_to=/backup/

PUT
/[path]Subir un archivo al almacenamiento del servidor
POST
/api/v1/files/[path]Operaciones de archivo: mkdir, extract, move, copy
POST
/api/v1/files/copy/[path]Copiar archivo o directorio a nueva ubicación
POST
/api/v1/files/move/[path]Mover o renombrar archivo a nueva ruta
DELETE
/[path]Eliminar un archivo o directorio
GET
/[directory]?qBuscar archivos que coincidan con una consulta

Gestión de backends

[count, plural, =1 [# endpoint] other [# endpoints]]'

POST .../api/v1/backends/drive → [id: "backend_drive_abc"]

POST
/api/v1/backends/[type]Montar un backend de almacenamiento
GET
/api/v1/backendsListar todos los backends montados
GET
/api/v1/backends/[id]Obtener detalles del backend
GET
/api/v1/backends/[id]/testProbar la conexión del backend
DELETE
/api/v1/backends/[id]Desconectar backend

Sistema y journal

[count, plural, =1 [# endpoint] other [# endpoints]]'

GET .../api/v1/journal?path=src/&op=write

GET
/__hoody-files__/healthEstado de salud del servicio
GET
/api/v1/downloadsListar descargas activas
GET
/api/v1/extractionsListar extracciones activas
GET
/api/v1/journalConsultar el journal de mutaciones de archivos
inicio / kit / files / backends-matrix
TIPOS DE BACKEND

Todas las categorías de backend

Cuatro categorías de almacenamiento, una interfaz HTTP. Monta cualquier combinación y accede a todo a través del mismo patrón de URL.

Categoría
Proveedores
Tipo de montaje
Método de autenticación
Almacenamiento en la nube
31 proveedores incl. Google Drive, Dropbox, OneDrive, Box
Sistema de archivos virtual
OAuth / API Key
Almacenamiento de objetos
S3, Azure Blob, GCS, B2, Cloudflare R2 y más de 25 compatibles con S3
Ruta de bucket
IAM / Access Key
Protocolos de archivos
FTP, SFTP, SMB, WebDAV, HTTP, HDFS
Ruta de red
Contraseña / Clave / Anónimo
Especiales
Cache, Chunker, Combine, Crypt, Compress
En capas
Hereda del backend envuelto
inicio / kit / files / start

Cada archivo es una URL

Empieza a leer, verificar hashes y gestionar archivos en más de 60 proveedores con una interfaz HTTP. Files viene incluido en cada contenedor de Hoody.

Leer la documentación