List File Explorer Uploads

Lista o histórico de uploads realizados no File Explorer com suporte a paginação e filtros.

Endpoint

GET /storage-explorer/storage/uploads/history

Permissões Requeridas

• STORAGE_EXPLORER.READ

Query Parameters

Parâmetro	Tipo	Obrigatório	Descrição
page	integer	Não	Número da página (padrão: 1)
limit	integer	Não	Itens por página (padrão: 20, máx: 100)
folder_path	string	Não	Filtrar por caminho de pasta

Exemplo de Requisição

curl -X GET "https://maestro.dadosfera.ai/storage-explorer/storage/uploads/history?page=1&limit=20&folder_path=/raw/sales" \
  -H "Authorization: <JWT_TOKEN>"

Exemplo de Resposta

Success (200 OK):

{
  "uploads": [
    {
      "upload_id": "upl_m1n2o3p4",
      "folder_path": "/raw/sales",
      "uploaded_at": "2024-01-15T10:30:00Z",
      "uploaded_by": "user@dadosfera.ai",
      "file_count": 3,
      "total_size_bytes": 933888,
      "status": "completed",
      "files": [
        {
          "file_name": "orders_2024_01.csv",
          "file_size_bytes": 524288,
          "file_format": "csv"
        },
        {
          "file_name": "products_jan.xlsx",
          "file_size_bytes": 153600,
          "file_format": "excel"
        },
        {
          "file_name": "events.json",
          "file_size_bytes": 256000,
          "file_format": "json"
        }
      ]
    },
    {
      "upload_id": "upl_n2o3p4q5",
      "folder_path": "/raw/marketing",
      "uploaded_at": "2024-01-14T14:20:00Z",
      "uploaded_by": "marketing@dadosfera.ai",
      "file_count": 1,
      "total_size_bytes": 2048576,
      "status": "completed",
      "files": [
        {
          "file_name": "campaigns_q1.parquet",
          "file_size_bytes": 2048576,
          "file_format": "parquet"
        }
      ]
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 8,
    "total_items": 156,
    "items_per_page": 20,
    "has_next": true,
    "has_previous": false
  }
}

Response Fields

Campo	Tipo	Descrição
uploads	array	Lista de uploads
uploads[].upload_id	string	ID do upload
uploads[].folder_path	string	Caminho da pasta
uploads[].uploaded_at	string	Data do upload
uploads[].uploaded_by	string	Email do usuário
uploads[].file_count	integer	Número de arquivos
uploads[].status	string	Status (completed, processing, failed)
pagination	object	Informações de paginação

Códigos de Status

Código	Descrição
200	Lista retornada com sucesso
401	Não autenticado
403	Sem permissão STORAGE_EXPLORER.READ