Saltar al contenido principal
Zenovaydocs
3 min de lectura

Colección de API Bruno

La colección Bruno de Zenovay es un conjunto gratuito y de código abierto de solicitudes preconfiguradas para cada endpoint público de la External API. Bruno almacena solicitudes como simples archivos .bru en una carpeta que añades a git — nada sale de tu máquina.

Bruno es la alternativa de código abierto a Postman: sin cuenta en la nube, sin telemetría, sin precios por usuario.

Descargar

Descargar + abrirBash
curl -O https://docs.zenovay.com/downloads/bruno-zenovay-collection.zip
unzip bruno-zenovay-collection.zip
# Abre la carpeta bruno-zenovay-collection/ en la app de escritorio Bruno.

O bájalo directamente: bruno-zenovay-collection.zip (~16 KB).

Qué incluye

La colección contiene 16 solicitudes listas para ejecutar en estas categorías:

CategoríaSolicitudes
CuentaGET /usage
Sitios webGET /websites, GET /websites/:id
AnalyticsGET /analytics/:id, /visitors, /pages, /countries, /technology
Funciones 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 solicitud viene con:

  • La URL completa preconfigurada con {{baseUrl}}
  • El header X-API-Key correcto extraído del entorno
  • Una descripción de cada parámetro de consulta
  • Una respuesta de ejemplo en la pestaña de documentación

Configuración (60 segundos)

  1. Instalar Bruno — usebruno.com/downloads (macOS, Windows, Linux).
  2. Abrir la colección — Archivo → Abrir Colección → selecciona la carpeta bruno-zenovay-collection/ descomprimida.
  3. Elegir el entorno — menú desplegable arriba a la derecha → elige production (por defecto https://api.zenovay.com/api/external/v1).
  4. Añadir tu clave de API — abre el entorno, configura apiKey con una clave de app.zenovay.com → Configuración → Claves API.

Eso es todo. Haz clic en cualquier solicitud y pulsa Send.

Tu clave de API nunca se commitea. Bruno guarda los valores del entorno en archivos tipo .env bajo environments/ — el .gitignore de la colección los excluye. El archivo commiteado (environments/production.bru) solo contiene los nombres de las variables, no los secretos.

¿Por qué Bruno y no Postman?

  • Local primero — sin sincronización en la nube, sin cuenta de equipo
  • Nativo de Git — los archivos .bru se diferencian limpiamente en PRs
  • Sin telemetría — nada llama a casa
  • Gratis para equipos — sin precios por usuario en colecciones compartidas

Si ya usas Postman, la especificación OpenAPI en api.zenovay.com/openapi.json también se importa limpiamente allí. Mira la página de especificación OpenAPI.

Código fuente

La colección vive en el repo público api-zenovay bajo bruno/. Abre issues o PRs allí si detectas una solicitud que falte o esté desactualizada.

Relacionado

¿Fue útil esta página?