Referencia da API S3

Visao Geral

Memesplora fornece uma API compativel com AWS S3, permitindo que qualquer cliente compativel com S3 (como rclone, AWS CLI, MinIO Client) acesse diretamente os espacos de armazenamento.

Endpoint

Endereco da API S3: http://localhost:5213

Autenticacao

Usa o algoritmo de assinatura AWS Signature V4. A Access Key e a Secret Key sao obtidas na interface de administracao web.

APIs Suportadas

Operacoes de Bucket

Operacao	HTTP	Caminho
ListBuckets	GET	/
HeadBucket	HEAD	/{bucket}

Operacoes de Objeto

Operacao	HTTP	Caminho
GetObject	GET	/{bucket}/{key}
PutObject	PUT	/{bucket}/{key}
DeleteObject	DELETE	/{bucket}/{key}
HeadObject	HEAD	/{bucket}/{key}
ListObjects	GET	/{bucket}
ListObjectsV2	GET	/{bucket}?list-type=2
DeleteObjects	POST	/{bucket}?delete
CopyObject	PUT	/{bucket}/{key} (x-amz-copy-source)

Upload Multipart

Operacao	HTTP	Caminho
CreateMultipartUpload	POST	/{bucket}/{key}?uploads
UploadPart	PUT	/{bucket}/{key}?partNumber=&uploadId=
CompleteMultipartUpload	POST	/{bucket}/{key}?uploadId=
AbortMultipartUpload	DELETE	/{bucket}/{key}?uploadId=
ListParts	GET	/{bucket}/{key}?uploadId=

Exemplos de Uso

AWS CLI

aws configure --profile memesplora
aws s3 --endpoint-url http://localhost:5213 ls
aws s3 --endpoint-url http://localhost:5213 cp arquivo.txt s3://meu-espaco/
aws s3 --endpoint-url http://localhost:5213 ls s3://meu-espaco/

rclone

rclone config  # Selecione S3 Compatible
rclone copy arquivo.txt memesplora:meu-espaco/
rclone ls memesplora:meu-espaco/

Detalhes da Arquitetura

Consulte Arquitetura do Protocolo S3 para entender o design detalhado.