Pular para o conteúdo principal
Zenovaydocs
3 min de leitura

Coleção da API Bruno

A coleção Bruno do Zenovay é um conjunto gratuito e de código aberto de requisições pré-configuradas para cada endpoint público da External API. O Bruno armazena requisições como arquivos .bru simples em uma pasta que você versiona no git — nada sai da sua máquina.

Bruno é a alternativa de código aberto ao Postman: sem conta na nuvem, sem telemetria, sem cobrança por usuário.

Baixar

Baixar + abrirBash
curl -O https://docs.zenovay.com/downloads/bruno-zenovay-collection.zip
unzip bruno-zenovay-collection.zip
# Abra a pasta bruno-zenovay-collection/ no aplicativo de desktop Bruno.

Ou pegue direto: bruno-zenovay-collection.zip (~16 KB).

O que vem dentro

A coleção contém 16 requisições prontas para executar nestas categorias:

CategoriaRequisições
ContaGET /usage
SitesGET /websites, GET /websites/:id
AnalyticsGET /analytics/:id, /visitors, /pages, /countries, /technology
Recursos ProGET /heatmaps/:id/pages, /replays/:id/sessions, /errors/:id/groups
InsightsGET /insights/:id, /anomalies/:id, /retention/:id, /revenue/:id/ltv
Query StudioPOST /query/:id

Cada requisição vem com:

  • A URL completa pré-preenchida com {{baseUrl}}
  • O cabeçalho X-API-Key correto puxado do ambiente
  • Uma descrição de cada parâmetro de query
  • Um exemplo de resposta na aba de documentação

Configuração (60 segundos)

  1. Instale o Bruno — usebruno.com/downloads (macOS, Windows, Linux).
  2. Abra a coleção — Arquivo → Abrir Coleção → selecione a pasta bruno-zenovay-collection/ descompactada.
  3. Escolha o ambiente — dropdown no canto superior direito → escolha production (padrão https://api.zenovay.com/api/external/v1).
  4. Adicione sua chave de API — abra o ambiente, defina apiKey com uma chave de app.zenovay.com → Configurações → Chaves de API.

É isso. Clique em qualquer requisição e aperte Send.

Sua chave de API nunca é commitada. O Bruno guarda valores de ambiente em arquivos no estilo .env sob environments/ — o .gitignore da coleção os exclui. O arquivo commitado (environments/production.bru) contém apenas os nomes das variáveis, não os segredos.

Por que Bruno em vez de Postman?

  • Local primeiro — sem sincronização na nuvem, sem conta de equipe
  • Nativo do Git — arquivos .bru fazem diff limpo nos PRs
  • Sem telemetria — nada liga para casa
  • Grátis para times — sem cobrança por usuário em coleções compartilhadas

Se você já usa Postman, a especificação OpenAPI em api.zenovay.com/openapi.json também importa limpa por lá. Veja a página da especificação OpenAPI.

Código fonte

A coleção vive no repositório público api-zenovay sob bruno/. Abra issues ou PRs lá se notar uma requisição faltando ou desatualizada.

Relacionados

Esta página foi útil?