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 die gebruikt kan worden als alternatief voor tools zoals Postman.

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-gebaseerd werkt.

Navigeer naar Bruno - The Git-Native API Client om Bruno te downloaden.

2. Belangrijkste eigenschappen

Local-first

geen account nodig
geen cloud opslag
alle data blijft lokaal

Dit maakt het geschikt voor omgevingen waar security en privacy belangrijk zijn.

Git-native

API collections worden opgeslagen als bestanden
deze bestanden kunnen onderdeel zijn van de repository
wijzigingen zijn inzichtelijk via Git

👉 API requests kunnen dus op dezelfde manier beheerd worden als code.

Lichtgewicht en developer-focused

snelle en eenvoudige interface
geen overbodige features
gericht op het testen van API’s

Ondersteuning voor API testing

HTTP requests uitvoeren
headers en body configureren
responses analyseren
eenvoudige validaties uitvoeren

3. Vergelijking met Postman

Bruno wordt vaak gebruikt als alternatief voor Postman.

Belangrijkste verschillen:

Onderdeel	Bruno	Postman
Data opslag	Lokaal (filesystem)	Cloud / workspace
Account nodig	Nee	Ja (meestal verplicht)
Git integratie	Direct (bestanden)	Indirect
Complexiteit	Lichtgewicht	Zwaarder platform
Gebruik	Developer-focused	Breder (ook API management)

👉 In dit project heeft Bruno de voorkeur vanwege:

eenvoud
volledige controle over data
integratie met Git
geen afhankelijkheid van externe platformen

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

Onderstaand een voorbeeld van een GET-request naar een publieke REST API (JSONPlaceholder).

GET request

GET https://jsonplaceholder.typicode.com/users/<id>

Waarbij:

<id> een variabele is die het unieke ID van de resource bevat
de API publiek toegankelijk is en geen authenticatie vereist
de response standaard wordt teruggegeven in JSON-formaat

Response (voorbeeld)

{
  "id": 1,
  "name": "Leanne Graham",
  "username": "Bret",
  "email": "example@email.com",
  "address": {
    "city": "Gwenborough"
  },
  "website": "example.org"
  ...
}

6. Best practices

Voor gebruik van Bruno gelden de volgende richtlijnen:

Gebruik Bruno voor handmatige API-validatie en debugging
Sla collections op binnen de repository indien relevant
Gebruik consistente naming voor requests
Documenteer complexe requests indien deze gedeeld worden
Gebruik Bruno als aanvulling op automatisering (niet als vervanging van tests)

7. Positionering binnen de oplossing

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

Het wordt gebruikt als:

developer tooling
API test client
debugging hulpmiddel

👉 Bruno wordt gebruikt ter ondersteuning van:

unit tests (services)
FakeXrmEasy tests (plugins)
DevOps pipelines

8. Samenvatting

Bruno is een eenvoudige en krachtige tool voor het testen van API’s.
Binnen deze architectuur wordt het gebruikt om:

API’s te valideren
integraties te testen
debugging te ondersteunen

Dankzij de local-first en Git-native aanpak sluit Bruno goed aan op de ontwikkelstandaarden.

🔌 Testen van HTTP-calls met Bruno