API de Arquivos — Documentacao e Testes

Upload

POST https://api.s3storage.me/upload

Content-Type: multipart/form-data

Authorization: Bearer <SEU_TOKEN>

Campos: brand (string), folder (string, ex: onboarding) e files[] (JPG, PNG, PDF).

Exemplo cURL

curl -X POST "https://api.s3storage.me/upload" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -F "brand=notrevepagamentos" \
  -F "folder=onboarding" \
  -F "files[]=@/caminho/arquivo1.pdf" \
  -F "files[]=@/caminho/selfie.png"

Tester Web

Resposta

Resposta (padrao)

{
  "status": "ok",
  "brand": "notrevepagamentos",
  "folder": "onboarding",
  "files": [
    {
      "status": "ok",
      "original_name": "documento.pdf",
      "mime": "application/pdf",
      "size": 123456,
      "hash": "sha256...",
      "filename": "sha256....pdf",
      "url": "https://dominio/uploads/notrevepagamentos/onboarding/sha256....pdf"
    }
  ]
}

Delete

DELETE https://api.s3storage.me/delete

Content-Type: application/json (quando usar DELETE)

Authorization: Bearer <SEU_TOKEN>

Envie brand, folder e um identificador: hash ou filename.

Exemplo cURL (DELETE por hash)

curl -X DELETE "https://api.s3storage.me/delete" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{"brand":"notrevepagamentos","folder":"onboarding","hash":"HASH_AQUI"}'

Exemplo cURL (POST por filename)

curl -X POST "https://api.s3storage.me/delete" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -d "brand=notrevepagamentos&folder=onboarding&filename=ARQUIVO_AQUI"

Tester Web

Resposta

Resposta (padrao)

{
  "status": "ok",
  "brand": "notrevepagamentos",
  "folder": "onboarding",
  "deleted": "nome-do-arquivo.ext"
}

List

GET https://api.s3storage.me/list?brand=<brand>&folder=<folder>&page=<n>&per_page=<n>&prefix=<prefix>

Authorization: Bearer <SEU_TOKEN>

Lista arquivos em uploads/<brand>/<folder>, com paginacao e filtro por prefix (hash ou inicio do filename).

Exemplo cURL

curl -X GET "https://api.s3storage.me/list?brand=notrevepagamentos&folder=onboarding&page=1&per_page=20" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI"

Tester Web

Resposta

Resposta (padrao)

{
  "status": "ok",
  "brand": "notrevepagamentos",
  "folder": "onboarding",
  "page": 1,
  "per_page": 20,
  "total": 123,
  "items": [
    {
      "filename": "sha256....pdf",
      "url": "https://dominio/uploads/notrevepagamentos/onboarding/sha256....pdf",
      "size": 123456,
      "mime": "application/pdf",
      "mtime": 1731460000,
      "hash": "sha256..."
    }
  ]
}

Notas de seguranca

Use sempre HTTPS.
Rotacione tokens periodicamente e nao exponha em clientes.
Restrinja brand/folder conforme sua politica.
Opcional: registre metadados no banco (hash, url, ip, usuario) e audite delete.