List Datasets by Upload

Lista todos os datasets associados a um upload específico.

Endpoint

GET /storage-explorer/datasets/upload/{uploadId}

Permissões Requeridas

STORAGE_EXPLORER.READ

Path Parameters

Parâmetro	Tipo	Descrição
`uploadId`	string	ID do upload

Exemplo de Requisição

curl -X GET "https://maestro.dadosfera.ai/storage-explorer/datasets/upload/upl_m1n2o3p4" \
  -H "Authorization: <JWT_TOKEN>"

Exemplo de Resposta

Success (200 OK):

{
  "upload_id": "upl_m1n2o3p4",
  "uploaded_at": "2024-01-15T10:30:00Z",
  "uploaded_by": "[email protected]",
  "folder_path": "/uploads/2024/01",
  "datasets": [
    {
      "dataset_id": "ds_x1y2z3",
      "dataset_name": "orders_2024_01.csv",
      "file_path": "/uploads/2024/01/orders_2024_01.csv",
      "file_format": "csv",
      "file_size_bytes": 524288,
      "row_count": 5420,
      "column_count": 5,
      "status": "ready",
      "created_at": "2024-01-15T10:30:15Z"
    },
    {
      "dataset_id": "ds_a2b3c4",
      "dataset_name": "products_jan.xlsx",
      "file_path": "/uploads/2024/01/products_jan.xlsx",
      "file_format": "excel",
      "file_size_bytes": 153600,
      "row_count": 850,
      "column_count": 8,
      "status": "ready",
      "created_at": "2024-01-15T10:30:20Z",
      "sheets": [
        {
          "sheet_name": "Products",
          "row_count": 850
        }
      ]
    },
    {
      "dataset_id": "ds_b3c4d5",
      "dataset_name": "events.json",
      "file_path": "/uploads/2024/01/events.json",
      "file_format": "json",
      "file_size_bytes": 256000,
      "row_count": 1200,
      "column_count": 12,
      "status": "ready",
      "created_at": "2024-01-15T10:30:25Z"
    }
  ],
  "total_datasets": 3,
  "total_size_bytes": 933888
}

Response Fields

Campo	Tipo	Descrição
`upload_id`	string	ID do upload
`uploaded_at`	string	Data do upload
`uploaded_by`	string	Usuário que fez o upload
`datasets`	array	Lista de datasets do upload
`datasets[].dataset_id`	string	ID do dataset
`datasets[].file_format`	string	Formato do arquivo
`datasets[].status`	string	Status do dataset (ready, processing, error)
`datasets[].sheets`	array	Sheets (apenas para Excel)
`total_datasets`	integer	Total de datasets
`total_size_bytes`	integer	Tamanho total

Códigos de Status

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