API de Arquivos — Documentacao e Testes

Upload

POST https://storage.notrevepay.com.br/upload

Content-Type: multipart/form-data

Authorization: Bearer <SEU_TOKEN>

Campos obrigatorios: brand (string) e folder/path (string). O caminho pode ter varios niveis, ex: teste/logs/2026/02.

Arquivos: files[] (multiplos). Tipos aceitos: jpg, png, pdf, log (text/plain) e json.

Nome do arquivo (opcional): filename + ext (valem para todos os arquivos do request) ou filenames[] + exts[] (um por arquivo, mesma ordem de files[]). Se nao informar, o servidor gera um nome aleatorio e devolve no JSON.

Regras de seguranca para log/json: so pode enviar se a pasta comecar com logs/ e tamanho maximo (tipico) de 1MB.

Exemplo cURL (PDF/Imagem)

curl -X POST "https://storage.notrevepay.com.br/upload" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -F "brand=mybucket" \
  -F "folder=onboarding" \
  -F "files[]=@/caminho/arquivo1.pdf" \
  -F "files[]=@/caminho/selfie.png"

Exemplo cURL (LOG + nome definido)

curl -X POST "https://storage.notrevepay.com.br/upload" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -F "brand=mybucket" \
  -F "folder=logs/webhook/myapplication" \
  -F "filename=2026-02-12_081530" \
  -F "ext=log" \
  -F "files[]=@/caminho/log.txt"

Tester Web

Resposta

Resposta (padrao)

{
  "status": "ok",
  "brand": "mybucket",
  "path": "logs/webhook/myapplication",
  "files": [
    {
      "status": "ok",
      "original_name": "log.txt",
      "mime": "text/plain",
      "size": 1234,
      "filename": "2026-02-12_081530.log",
      "generated_name": false,
      "final_ext": "log",
      "url": "https://dominio/uploads/mybucket/logs/webhook/myapplication/2026-02-12_081530.log"
    }
  ]
}

Delete

DELETE https://storage.notrevepay.com.br/delete

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

Authorization: Bearer <SEU_TOKEN>

Envie brand, folder/path e um identificador: filename. Se seu sistema ainda usa hash, voce pode manter o modo por hash.

Exemplo cURL (DELETE por filename)

curl -X DELETE "https://storage.notrevepay.com.br/delete" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{"brand":"mybucket","folder":"logs/webhook/myapplication","filename":"2026-02-12_081530.log"}'

Exemplo cURL (POST por filename)

curl -X POST "https://storage.notrevepay.com.br/delete" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -d "brand=mybucket&folder=logs/webhook/myapplication&filename=2026-02-12_081530.log"

Tester Web

Resposta

Resposta (padrao)

{
  "status": "ok",
  "brand": "mybucket",
  "folder": "logs/webhook/myapplication",
  "deleted": "2026-02-12_081530.log"
}

List

GET https://storage.notrevepay.com.br/list?brand=<brand>&folder=<folder>&page=<n>&per_page=<n>&prefix=<prefix>

Authorization: Bearer <SEU_TOKEN>

Lista arquivos em uploads/<brand>/<folder>. prefix filtra por inicio do filename (funciona para nomes gerados ou definidos).

Exemplo cURL

curl -X GET "https://storage.notrevepay.com.br/list?brand=mybucket&folder=onboarding&page=1&per_page=20" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI"

Tester Web

Resposta

Resposta (padrao)

{
  "status": "ok",
  "brand": "mybucket",
  "folder": "onboarding",
  "page": 1,
  "per_page": 20,
  "total": 123,
  "items": [
    {
      "filename": "2026-02-12_081530.log",
      "url": "https://dominio/uploads/mybucket/logs/webhook/myapplication/2026-02-12_081530.log",
      "size": 1234,
      "mime": "text/plain",
      "mtime": 1731460000
    }
  ]
}

Notas de seguranca

Use sempre HTTPS.
Rotacione tokens periodicamente e nao exponha em clientes.
Para logs/json, use folder iniciando com logs/ e mantenha tamanho pequeno.
Opcional: registre metadados no banco (filename, url, ip, usuario) e audite delete.