Pular para o conteúdo
início / kit / files
FilesFILES

Todo Arquivo É Uma URL

Uma interface HTTP para armazenamento local e mais de 60 provedores na nuvem — Google Drive, S3, Dropbox, MEGA e mais.

hoody-files · acesso universal a armazenamento

# 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

# mesmo padrão de URL

HTTP/1.1 200 OK

Content-Type: application/pdf

Content-Length: 524288

# armazenamento diferente

HTTP/1.1 200 OK

Content-Type: application/zip

ETag: "a3f2bc..."

Mesmo padrão de URL. Armazenamento diferente. Sem complexidade.

início / kit / files / backends
60+ PROVEDORES

Conecte Qualquer Armazenamento, Instantaneamente

Monte Google Drive, S3, Dropbox e mais de 60 provedores. Com o mesmo padrão de URL.

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
início / kit / files / protocolos
PROTOCOLOS DE ARQUIVO

Fale Qualquer Protocolo de Armazenamento

FTP, SFTP, SMB, WebDAV, HTTP e HDFS — monte armazenamento de rede usando qualquer protocolo que seu servidor suporte.

FTPporta 21
SFTPporta 22
SMBporta 445
WebDAVNextcloud / SharePoint
HTTPservidores de arquivos web
HDFSclusters Hadoop
início / kit / files / capacidades
CAPACIDADES

Mais que Hospedagem de Arquivos

Transmita, faça hash, visualize, comprima, registre e processe imagens — tudo por uma única interface HTTP.

Leitura e Streaming

Transmita qualquer arquivo via HTTP do armazenamento local ou qualquer backend de nuvem montado. Suporta HTML, JSON, imagens, binários.

GET /api/v1/files/[path]

Integridade SHA256

Calcule hashes SHA256 ou MD5 sem baixar o arquivo completo. Essencial para pipelines de produção.

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

Prévia de Arquivo Comprimido

Inspecione conteúdo de .tar.gz e .zip sem extrair o arquivo. Liste entradas, tamanhos e metadados.

GET /[path]?preview

Diretório como .zip

Baixe qualquer diretório como arquivo .zip sob demanda. Funciona para armazenamento local e remoto na nuvem.

GET /[path]?zip

Diário e Histórico de Arquivos

Toda mutação é registrada com snapshot de blob endereçável por conteúdo. Leia qualquer arquivo em qualquer ponto no tempo.

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

Processamento de Imagens

Redimensionamento on-the-fly, conversão de formato, desfoque e escala de cinza para JPEG, PNG, WebP, GIF e BMP.

GET /[image]?thumbnail&width=400
início / kit / files / api
REFERÊNCIA DE API

21 Endpoints. Uma Interface.

Leia, escreva, gerencie backends e monitore o diário — tudo exposto via HTTP limpo.

Leitura e Download

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

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

GET
/api/v1/files/[path]Ler ou baixar conteúdo do arquivo
GET
/[path]Listar diretório como JSON
HEAD
/api/v1/files/[path]Listar diretório como texto simples
GET
/api/v1/files/[path]?hashHash SHA256 do arquivo
GET
/[path]?previewArquivo como Base64
GET
/[path]?zipMetadados do arquivo

Escrita e Mutação

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

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

PUT
/[path]Prévia de arquivo comprimido
POST
/api/v1/files/[path]Diretório como zip
POST
/api/v1/files/copy/[path]Thumbnail de imagem
POST
/api/v1/files/move/[path]Escrever ou fazer upload de arquivo
DELETE
/[path]Excluir arquivo ou diretório
GET
/[directory]?qCriar diretório

Gerenciamento de Backends

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

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

POST
/api/v1/backends/[type]Copiar arquivo ou diretório
GET
/api/v1/backendsMover / renomear arquivo
GET
/api/v1/backends/[id]Listar backends conectados
GET
/api/v1/backends/[id]/testConectar backend de nuvem
DELETE
/api/v1/backends/[id]Desconectar backend

Sistema e Diário

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

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

GET
/__hoody-files__/healthTestar conexão do backend
GET
/api/v1/downloadsHistórico de versões do arquivo
GET
/api/v1/extractionsLog de atividades do arquivo
GET
/api/v1/journalInformações de uso do armazenamento
início / kit / files / matriz-backends
TIPOS DE BACKEND

Toda categoria de backend

Quatro categorias de armazenamento, uma interface HTTP. Monte qualquer combinação e acesse todas pelo mesmo padrão de URL.

Categoria
Provedores
Tipo de montagem
Método de autenticação
Armazenamento em nuvem
31 provedores incl. Google Drive, Dropbox, OneDrive, Box
Sistema de arquivos virtual
OAuth / API Key
Armazenamento de objetos
S3, Azure Blob, GCS, B2, Cloudflare R2 e mais de 25 compatíveis com S3
Caminho de bucket
IAM / Access Key
Protocolos de arquivo
FTP, SFTP, SMB, WebDAV, HTTP, HDFS
Caminho de rede
Senha / Chave / Anônimo
Especial
Cache, Chunker, Combine, Crypt, Compress
Em camadas
Herda do backend encapsulado
início / kit / files / começar

Cada arquivo é uma URL

Comece a ler, calcular hashes e gerenciar arquivos em mais de 60 provedores com uma interface HTTP. Files está incluído em todo contêiner Hoody.

Ler a Documentação