Pular para o conteúdo principal

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ãoOperações
STORAGE_EXPLORER.READListar tabelas, datasets, arquivos; visualizar schemas e metadados
STORAGE_EXPLORER.WRITECriar 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ódigoDescrição
400Bad Request - Parâmetros inválidos ou customer_id ausente
401Unauthorized - Token JWT inválido ou ausente
403Forbidden - Permissões insuficientes
404Not Found - Recurso não encontrado
500Internal Server Error - Erro interno no Storage Explorer
503Service Unavailable - Storage Explorer API indisponível
504Gateway 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 "files=@data.csv" \
  -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>"

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