🧰 Bruno

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

📖 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 ontwikkelaanpak 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 desktopapplicatie waarmee HTTP-requests uitgevoerd en geanalyseerd kunnen worden.

Toepassingen

REST API's testen
HTTP-calls uitvoeren (GET, POST, PUT, DELETE)
Responses analyseren
Integraties en Custom API's valideren

💡 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 cloudopslag
Alle data blijft lokaal

💡 Geschikt voor omgevingen waar security en privacy belangrijk zijn.

🌿 Git-native

API collections worden opgeslagen als bestanden
Onderdeel van een repository
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 configureren
Request body beheren
Responses analyseren
Eenvoudige validaties uitvoeren

3. Vergelijking: Bruno vs Postman vs curl

Onderdeel	Bruno	Postman	curl
Type tool	Desktop API Client	API Platform (desktop + cloud)	Command line tool
Gebruik	Developer-focused API testing	Complete API lifecycle	HTTP debugging
Interface	Grafisch (lichtgewicht)	Grafisch (uitgebreid)	CLI
Data opslag	Lokaal (filesystem)	Cloud workspaces	N.v.t.
Git integratie	✅ Native	⚠️ Via export/import	✅ Via scripts
Offline gebruik	✅ Volledig offline	⚠️ Gedeeltelijk cloudafhankelijk	✅ Volledig offline
Complexiteit	Lichtgewicht	Hoog	Laag
Automatisering	Basis	Geavanceerd	Scriptbaar
Team Collaboration	Via Git	✅ Ingebouwd	❌ Niet aanwezig
Mocking / Monitoring	❌ Niet standaard	✅ Ja	❌ Nee
Setup	Eenvoudig	Account + configuratie	Geen
Geschikt voor	Developers / Git workflows	Teams / Enterprise API management	Developers / Automation

Samenvatting

Bruno → Beste keuze voor developer-focused Git-workflows
Postman → Beste keuze voor teams en uitgebreide API lifecycle-functionaliteit
curl → Beste keuze voor debugging en command-line automatisering

⚠️ In veel projecten worden deze tools gecombineerd:

Bruno → Development & Debugging

Postman → Samenwerking & Documentatie

curl → Automatisering & 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 (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 binnen de repository

✅ Gebruik consistente naamgeving voor requests

✅ Documenteer complexe requests

✅ Gebruik Bruno als aanvulling op geautomatiseerde tests

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

Aanvulling op

Unit Tests
FakeXrmEasy Tests
DevOps Pipelines
CI/CD Processen

✅ Checklist

Installatie

☐ Bruno geïnstalleerd
☐ Collections ingericht
☐ Omgevingen geconfigureerd

Development

☐ API's getest
☐ Headers gevalideerd
☐ Responses gecontroleerd
☐ Edge cases getest

ALM

☐ Collections opgeslagen in Git
☐ Naming conventions toegepast
☐ Teamafspraken vastgelegd

Kwaliteit

☐ Foutscenario's getest
☐ Authenticatie gecontroleerd
☐ Integraties gevalideerd

⚠️ Veelgemaakte Fouten

🚩 Alleen succesvolle scenario's testen

🚩 Geen foutafhandeling valideren

🚩 Collections buiten Git bewaren

🚩 Geheimen of API keys committen naar repositories

🚩 Bruno gebruiken als vervanging van geautomatiseerde tests

🚩 Integraties testen zonder representatieve data

💡 Richtlijnen

Security

Gebruik environment variables
Sla API keys niet hardcoded op
Gebruik gescheiden omgevingen

Herbruikbaarheid

Gebruik consistente naamgeving
Groepeer requests logisch
Documenteer uitzonderingen

Samenwerking

Beheer collections via Git
Gebruik pull requests
Houd documentatie actueel

📊 Samenvatting

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

✅ Valideren van API's

✅ Testen van integraties

✅ Ondersteunen van debugging

✅ Git-native samenwerking

✅ Local-first ontwikkeling

Door de local-first en Git-native aanpak sluit Bruno uitstekend aan op moderne ALM-, DevOps- en Power Platform-ontwikkelstandaarden. ``