Zum Hauptinhalt springen
Zenovaydocs
3 Min. Lesedauer

Bruno API-Sammlung

Die Zenovay Bruno-Sammlung ist eine kostenlose, quelloffene Reihe vorkonfigurierter Anfragen für jeden öffentlichen Endpunkt der External API. Bruno speichert Anfragen als reine .bru-Dateien in einem Ordner, den du in git eincheckst — nichts verlässt deine Maschine.

Bruno ist die Open-Source-Alternative zu Postman: kein Cloud-Konto, keine Telemetrie, keine Pro-Sitz-Preise.

Herunterladen

Herunterladen + öffnenBash
curl -O https://docs.zenovay.com/downloads/bruno-zenovay-collection.zip
unzip bruno-zenovay-collection.zip
# Öffne den bruno-zenovay-collection/-Ordner in der Bruno-Desktop-App.

Oder direkt holen: bruno-zenovay-collection.zip (~16 KB).

Was ist drin

Die Sammlung enthält 16 sofort einsatzbereite Anfragen in diesen Kategorien:

KategorieAnfragen
KontoGET /usage
WebsitesGET /websites, GET /websites/:id
AnalyticsGET /analytics/:id, /visitors, /pages, /countries, /technology
Pro-FeaturesGET /heatmaps/:id/pages, /replays/:id/sessions, /errors/:id/groups
InsightsGET /insights/:id, /anomalies/:id, /retention/:id, /revenue/:id/ltv
Query StudioPOST /query/:id

Jede Anfrage kommt mit:

  • Der vollständigen URL, vorausgefüllt mit {{baseUrl}}
  • Dem korrekten X-API-Key-Header aus der Umgebung
  • Einer Beschreibung jedes Abfrageparameters
  • Einer Beispielantwort im Dokumentations-Tab

Einrichtung (60 Sekunden)

  1. Bruno installieren — usebruno.com/downloads (macOS, Windows, Linux).
  2. Sammlung öffnen — Datei → Sammlung öffnen → den entpackten bruno-zenovay-collection/-Ordner auswählen.
  3. Umgebung wählen — Dropdown oben rechts → production wählen (standardmäßig https://api.zenovay.com/api/external/v1).
  4. API-Schlüssel hinzufügen — Umgebung öffnen, apiKey auf einen Schlüssel von app.zenovay.com → Einstellungen → API Keys setzen.

Das war's. Klick auf eine Anfrage und drück Send.

Dein API-Schlüssel wird nie eingecheckt. Bruno speichert Umgebungswerte in .env-ähnlichen Dateien unter environments/ — das .gitignore der Sammlung schließt sie aus. Die eingecheckte Datei (environments/production.bru) enthält nur die Variablennamen, nicht die Geheimnisse.

Warum Bruno statt Postman?

  • Lokal zuerst — keine Cloud-Synchronisierung, kein Team-Konto erforderlich
  • Git-nativ — .bru-Dateien lassen sich sauber in PRs diffen
  • Keine Telemetrie — nichts ruft nach Hause
  • Kostenlos für Teams — keine Pro-Sitz-Preise für geteilte Sammlungen

Wenn du bereits Postman nutzt, importiert die OpenAPI-Spezifikation unter api.zenovay.com/openapi.json auch dort sauber. Siehe die OpenAPI-Spezifikationsseite.

Quelle

Die Sammlung lebt im öffentlichen api-zenovay-Repo unter bruno/. Eröffne dort Issues oder PRs, wenn du eine fehlende oder veraltete Anfrage entdeckst.

Verwandt

War diese Seite hilfreich?