Browse Storage

Navega pela estrutura de pastas e arquivos no storage do cliente.

Endpoint

GET /storage-explorer/storage/browse

Permissões Requeridas

• STORAGE_EXPLORER.READ

Query Parameters

Parâmetro	Tipo	Obrigatório	Descrição
path	string	Não	Caminho da pasta (padrão: root "/")

Exemplo de Requisição

curl -X GET "https://maestro.dadosfera.ai/storage-explorer/storage/browse?path=/raw/sales" \
  -H "Authorization: <JWT_TOKEN>"

Exemplo de Resposta

Success (200 OK):

{
  "current_path": "/raw/sales",
  "parent_path": "/raw",
  "items": [
    {
      "name": "2024",
      "type": "folder",
      "path": "/raw/sales/2024",
      "created_at": "2024-01-01T00:00:00Z",
      "modified_at": "2024-01-15T10:30:00Z",
      "item_count": 12
    },
    {
      "name": "archive",
      "type": "folder",
      "path": "/raw/sales/archive",
      "created_at": "2023-12-01T00:00:00Z",
      "modified_at": "2024-01-10T14:20:00Z",
      "item_count": 156
    },
    {
      "name": "orders_2024_01.csv",
      "type": "file",
      "path": "/raw/sales/orders_2024_01.csv",
      "size_bytes": 524288,
      "created_at": "2024-01-15T10:30:00Z",
      "modified_at": "2024-01-15T10:30:00Z",
      "file_format": "csv",
      "dataset_id": "ds_x1y2z3"
    },
    {
      "name": "products_jan.xlsx",
      "type": "file",
      "path": "/raw/sales/products_jan.xlsx",
      "size_bytes": 153600,
      "created_at": "2024-01-15T10:30:00Z",
      "modified_at": "2024-01-15T10:30:00Z",
      "file_format": "excel",
      "dataset_id": "ds_a2b3c4"
    },
    {
      "name": "events.json",
      "type": "file",
      "path": "/raw/sales/events.json",
      "size_bytes": 256000,
      "created_at": "2024-01-15T10:30:00Z",
      "modified_at": "2024-01-15T10:30:00Z",
      "file_format": "json",
      "dataset_id": "ds_b3c4d5"
    }
  ],
  "total_items": 5,
  "total_folders": 2,
  "total_files": 3,
  "total_size_bytes": 933888
}

Response Fields

Campo	Tipo	Descrição
current_path	string	Caminho atual
parent_path	string	Caminho do diretório pai
items	array	Lista de pastas e arquivos
items[].type	string	Tipo do item (folder, file)
items[].path	string	Caminho completo
items[].size_bytes	integer	Tamanho em bytes (apenas arquivos)
items[].file_format	string	Formato do arquivo
items[].dataset_id	string	ID do dataset (se existir)
total_items	integer	Total de itens

Navegação

Para navegar para subpastas, use o path retornado:

# Navegar para pasta 2024
curl -X GET "https://maestro.dadosfera.ai/storage-explorer/storage/browse?path=/raw/sales/2024" \
  -H "Authorization: <JWT_TOKEN>"

Códigos de Status

Código	Descrição
200	Conteúdo retornado com sucesso
401	Não autenticado
403	Sem permissão STORAGE_EXPLORER.READ
404	Caminho não encontrado