Storage Explorer API

A Storage Explorer API fornece endpoints para gerenciar arquivos, tabelas e datasets no storage da Dadosfera através de proxy do Maestro.

Visão Geral

A API está organizada em três categorias principais:

Tables (Tabelas): Criar, listar e gerenciar tabelas do módulo de Consulta, disponíveis ou não no Catálogo
Datasets: Visualizar schemas, previews e gerenciar datasets vinculados a tabelas
Storage: Upload, download, navegação e gerenciamento de arquivos no storage

Autenticação

Todos os endpoints requerem autenticação JWT via header Authorization.

Authorization: <JWT_TOKEN>

Permissões

Permissão	Operações
`STORAGE_EXPLORER.READ`	Listar tabelas, datasets, arquivos; visualizar schemas e metadados
`STORAGE_EXPLORER.WRITE`	Criar tabelas, fazer upload de arquivos, criar pastas, vincular datasets

Recursos Principais

Gerenciamento de Tabelas

Validação de nomes de tabelas
Criação de tabelas no Snowflake
Listagem com paginação
Vinculação com datasets
Validação de compatibilidade de schemas

Exploração de Datasets

Preview de dados (limitado)
Consulta de schemas
Atualização de configurações de parsing (Excel)
Listagem por upload

Operações de Storage

Upload de múltiplos arquivos (batch)
Download de arquivos
Navegação de diretórios
Criação de pastas
Histórico de uploads
Metadados de arquivos

Timeouts

Timeout padrão: 30 segundos

Configurável via variável de ambiente STORAGE_EXPLORER_TIMEOUT.

Estrutura de Erros

A API retorna códigos HTTP padrão:

Código	Descrição
`400`	Bad Request - Parâmetros inválidos ou customer_id ausente
`401`	Unauthorized - Token JWT inválido ou ausente
`403`	Forbidden - Permissões insuficientes
`404`	Not Found - Recurso não encontrado
`500`	Internal Server Error - Erro interno no Storage Explorer
`503`	Service Unavailable - Storage Explorer API indisponível
`504`	Gateway Timeout - Timeout na requisição ao Storage Explorer

Exemplos de Uso

Listar Tabelas

curl -X GET "https://maestro.dadosfera.ai/storage-explorer/tables?page=1" \
  -H "Authorization: <JWT_TOKEN>"

Upload de Arquivo

curl -X POST "https://maestro.dadosfera.ai/storage-explorer/storage/upload/batch" \
  -H "Authorization: <JWT_TOKEN>" \
  -F "[email protected]" \
  -F "folder_path=/raw/sales"

Preview de Dataset

curl -X GET "https://maestro.dadosfera.ai/storage-explorer/datasets/abc123/preview?limit=10" \
  -H "Authorization: <JWT_TOKEN>"

Navegação

Use o menu lateral para acessar a documentação detalhada de cada endpoint.