Aller au contenu principal
Zenovaydocs
3 min de lecture

Collection API Bruno

La collection Bruno de Zenovay est un ensemble gratuit et open-source de requêtes préconfigurées pour chaque endpoint public de l'External API. Bruno stocke les requêtes sous forme de fichiers .bru dans un dossier que vous versionnez avec git — rien ne quitte votre machine.

Bruno est l'alternative open-source à Postman : pas de compte cloud, pas de télémétrie, pas de tarification par siège.

Télécharger

Télécharger + ouvrirBash
curl -O https://docs.zenovay.com/downloads/bruno-zenovay-collection.zip
unzip bruno-zenovay-collection.zip
# Ouvrez le dossier bruno-zenovay-collection/ dans l'application de bureau Bruno.

Ou téléchargez-le directement : bruno-zenovay-collection.zip (~16 Ko).

Ce qui est inclus

La collection contient 16 requêtes prêtes à l'emploi dans ces catégories :

CatégorieRequêtes
CompteGET /usage
Sites webGET /websites, GET /websites/:id
AnalyticsGET /analytics/:id, /visitors, /pages, /countries, /technology
Fonctionnalités ProGET /heatmaps/:id/pages, /replays/:id/sessions, /errors/:id/groups
InsightsGET /insights/:id, /anomalies/:id, /retention/:id, /revenue/:id/ltv
Query StudioPOST /query/:id

Chaque requête est livrée avec :

  • L'URL complète pré-remplie avec {{baseUrl}}
  • Le bon header X-API-Key tiré de l'environnement
  • Une description de chaque paramètre de requête
  • Une réponse d'exemple dans l'onglet documentation

Configuration (60 secondes)

  1. Installer Bruno — usebruno.com/downloads (macOS, Windows, Linux).
  2. Ouvrir la collection — Fichier → Ouvrir Collection → sélectionnez le dossier bruno-zenovay-collection/ décompressé.
  3. Choisir l'environnement — menu déroulant en haut à droite → choisissez production (par défaut https://api.zenovay.com/api/external/v1).
  4. Ajouter votre clé API — ouvrez l'environnement, définissez apiKey sur une clé depuis app.zenovay.com → Paramètres → Clés API.

C'est tout. Cliquez sur n'importe quelle requête et appuyez sur Send.

Votre clé API n'est jamais commit. Bruno stocke les valeurs d'environnement dans des fichiers de type .env sous environments/ — le .gitignore de la collection les exclut. Le fichier versionné (environments/production.bru) ne contient que les noms de variables, pas les secrets.

Pourquoi Bruno plutôt que Postman ?

  • Local d'abord — pas de synchronisation cloud, pas de compte d'équipe requis
  • Compatible Git — les fichiers .bru se diffent proprement dans les PRs
  • Pas de télémétrie — rien ne phone-home
  • Gratuit pour les équipes — pas de tarification par siège sur les collections partagées

Si vous utilisez déjà Postman, la spécification OpenAPI sur api.zenovay.com/openapi.json s'y importe également proprement. Voir la page de spécification OpenAPI.

Code source

La collection vit dans le dépôt public api-zenovay sous bruno/. Ouvrez-y des issues ou des PRs si vous repérez une requête manquante ou obsolète.

Voir aussi

Cette page vous a-t-elle été utile ?