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": "[email protected]",
      "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": "[email protected]",
      "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