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": "user@dadosfera.ai",
  "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