🧰 Bruno

Tooling voor het testen en valideren van HTTP-calls en API endpoints binnen Power Platform oplossingen.

← Terug naar Develop

📖 Introductie

Bruno wordt gebruikt als tooling voor het testen en valideren van HTTP-calls en API endpoints.

Bruno is een lichtgewicht, developer-focused API client en vormt een alternatief voor tools zoals Postman. De tool sluit goed aan bij een moderne development aanpak waarin eenvoud, versiebeheer en lokale controle centraal staan.

👉 Bruno wordt gebruikt als praktische ondersteuning bij development, debugging en integratievalidatie.
⚠️ Bruno is een developer tool voor handmatige validatie en debugging. Het vervangt geen geautomatiseerde tests, monitoring of CI/CD pipelines.

1. Wat is Bruno?

Bruno is een desktop applicatie waarmee HTTP-requests uitgevoerd en geanalyseerd kunnen worden.

Het wordt gebruikt voor:

  • testen van REST API’s
  • uitvoeren van HTTP-calls (GET, POST, PUT, DELETE)
  • analyseren van responses
  • valideren van integraties en Custom API’s
👉 Een belangrijk kenmerk van Bruno is dat het volledig local-first en Git-native werkt.

🔗 Bezoek de Bruno website

2. Belangrijkste eigenschappen

Local-first

  • Geen account nodig
  • Geen cloud opslag
  • Alle data blijft lokaal
👉 Geschikt voor omgevingen waar security en privacy belangrijk zijn.

Git-native

  • API collections worden opgeslagen als bestanden
  • Onderdeel van repository mogelijk
  • Volledige versioning via Git
👉 API requests worden beheerd zoals code.

Lichtgewicht en developer-focused

  • Eenvoudige interface
  • Snelle workflow
  • Geen overbodige features

API testing

  • HTTP requests uitvoeren
  • Headers en body configureren
  • Responses analyseren
  • Eenvoudige validaties

3. Vergelijking: Bruno vs Postman vs curl

Er zijn verschillende tools beschikbaar voor het testen van API’s. De keuze hangt af van gebruiksscenario, teamgrootte en gewenste complexiteit. Onderstaande tabel geeft een overzicht van de belangrijkste verschillen tussen Bruno, Postman en curl.

Onderdeel Bruno Postman curl
Type tool Desktop API client API platform (desktop + cloud) Command line tool
Gebruik Developer-focused API testing Volledige API lifecycle (design, test, monitor) Snel uitvoeren van HTTP-calls
Interface Grafisch (lichtgewicht) Grafisch (uitgebreid) CLI (terminal)
Data opslag Lokaal (filesystem, Git) Cloud workspaces Niet van toepassing
Git integratie ✅ Native (bestanden) ⚠️ Indirect (export/import) ✅ via scripts
Offline gebruik ✅ Volledig offline ⚠️ Beperkt (cloud afhankelijk) ✅ Volledig offline
Complexiteit Lichtgewicht Hoog (veel features) Laag (maar technisch)
Automatisering Basis (scripts, collections) Geavanceerd (CI/CD, monitoring) Ja (scripts, pipelines)
Team collaboration Via Git ✅ Ingebouwd (workspaces) ❌ Niet aanwezig
Mocking / monitoring ❌ Niet standaard ✅ Ja ❌ Nee
Setup Eenvoudig Account + configuratie Geen (CLI beschikbaar)
Geschikt voor Developers / Git workflows Teams / enterprise API management Developers / scripting / debugging
👉 Samenvattend:
  • Bruno → beste keuze voor developer-focused, Git-native workflows
  • Postman → beste keuze voor teams en uitgebreide API platform features
  • curl → beste keuze voor snelle debugging en scripting via command line
⚠️ In veel projecten worden deze tools gecombineerd:
  • Bruno → development & debugging
  • Postman → samenwerking en documentatie
  • curl → automatisering en pipelines

4. Gebruik

Bruno wordt gebruikt voor:

  • testen van Custom API’s
  • testen van externe integraties
  • valideren van HTTP responses
  • controleren van foutafhandeling

Typische scenario’s:

  • debuggen van API calls
  • validatie van input en output
  • testen van edge cases
  • reproduceren van issues

5. Voorbeeld

GET request

GET https://brenke-sandbox.eu1-salesbuildr.com/public-api/company/<id>

Waarbij:

  • <id> een variabele is
  • Een API key wordt meegegeven als header (bijv. x-api-key)

Response (voorbeeld)

{
  "id": "string",
  "name": "string",
  "externalIdentifier": "string",
  "type": "string"
}

6. Best practices

  • Gebruik Bruno voor handmatige API-validatie en debugging
  • Sla collections op in de repository indien relevant
  • Gebruik consistente naming voor requests
  • Documenteer complexe requests
  • Gebruik Bruno als aanvulling op automatisering

7. Positionering binnen de oplossing

Bruno is geen onderdeel van de runtime oplossing maar ondersteunt development en testing.

👉 Bruno fungeert als:
  • developer tooling
  • API test client
  • debugging hulpmiddel

Het vormt een aanvulling op:

  • unit tests
  • FakeXrmEasy tests
  • DevOps pipelines

📊 Samenvatting

Bruno is een eenvoudige en krachtige tool voor het testen van API’s.

✅ Valideren van API’s
✅ Testen van integraties
✅ Ondersteunen van debugging

Door de local-first en Git-native aanpak sluit Bruno goed aan op de ontwikkelstandaarden binnen Brenke.