Hoe test je een PATCH-verzoek in je REST API: stappenplan met cURL en Postman

Wat is een PATCH-verzoek en wanneer gebruik je het?

Een PATCH-verzoek is een HTTP-methode die je gebruikt om een bestaand record gedeeltelijk bij te werken. In tegenstelling tot PUT, waarbij je het volledige object vervangt, stuur je met PATCH alleen de velden mee die je wilt wijzigen. Dit bespaart bandbreedte en voorkomt dat je per ongeluk velden overschrijft die je niet wilde aanraken.

In dit artikel leer je hoe je een PATCH-verzoek correct test, zowel met cURL in de command line als met Postman. Je krijgt een stappenplan waarmee je vandaag zelf aan de slag kunt.

Waarom PATCH testen voordat je live gaat?

Een API die verkeerde data overschrijft of onverwachte velden negeert, leidt tot bugs in productie. Door PATCH-verzoeken goed te testen, controleer je of je endpoint:

• Alleen de meegegeven velden wijzigt. De overige velden intact laat. Correcte statuscodes teruggeeft (200 OK of 204 No Content bij succes, 400 Bad Request of 404 Not Found bij fouten)
• Validatieregels respecteert (bijvoorbeeld verplichte velden, juiste datatypes)

Stappenplan: PATCH-verzoek testen met cURL

cURL is een command line tool die standaard aanwezig is op Linux, macOS en moderne Windows-systemen. Je kunt er HTTP-verzoeken mee versturen zonder extra software.

Stap 1: Controleer welk record je wilt aanpassen

Verstuur eerst een GET-verzoek om de huidige staat van het record op te halen:

``` curl -X GET https://api.jouwdomein.be/api/gebruikers/42 ```

Noteer de waarden die je ziet. Zo kun je straks verifiëren dat alleen de juiste velden zijn gewijzigd.

Stap 2: Stel je PATCH-verzoek samen

Een PATCH-verzoek heeft minimaal drie onderdelen:

• De HTTP-methode (PATCH)
• De Content-Type header (meestal application/json)
• Een JSON-body met de velden die je wilt wijzigen

Voorbeeld:

``` curl -X PATCH https://api.jouwdomein.be/api/gebruikers/42 \ -H "Content-Type: application/json" \ -d '{"email": "nieuw@voorbeeld.be"}' ```

Stap 3: Voeg authenticatie toe

Als je API beveiligd is met een Bearer-token of API-sleutel, voeg dan de Authorization-header toe:

``` curl -X PATCH https://api.jouwdomein.be/api/gebruikers/42 \ -H "Content-Type: application/json" \ -H "Authorization: Bearer jouw-token-hier" \ -d '{"email": "nieuw@voorbeeld.be"}' ```

Stap 4: Verstuur het verzoek en controleer de response

Voer het commando uit. Een succesvolle PATCH geeft meestal statuscode 200 terug met het bijgewerkte object, of 204 zonder body. Krijg je een foutcode (400, 401, 404, 422), controleer dan:

• Of de URL en het ID kloppen. Of je token geldig is. Of de JSON-syntax correct is. Of de veldnamen overeenkomen met je API-documentatie

Stap 5: Verifieer met een nieuwe GET

Haal het record opnieuw op om te bevestigen dat de wijziging is doorgevoerd:

``` curl -X GET https://api.jouwdomein.be/api/gebruikers/42 ```

Controleer of alleen het email-veld is veranderd en de rest intact is gebleven.

Stappenplan: PATCH-verzoek testen met Postman

Postman is een gratis tool voor het testen van API's met een grafische interface. Download Postman via de officiële website postman.com.

Stap 1: Maak een nieuw verzoek aan

Open Postman en klik op New, kies HTTP Request. Stel de methode in op PATCH en vul de URL in:

``` https://api.jouwdomein.be/api/gebruikers/42 ```

Stap 2: Voeg headers toe

Ga naar het tabblad Headers en voeg toe:

• Key: Content-Type, Value: application/json. Key: Authorization, Value: Bearer jouw-token-hier (als je authenticatie gebruikt)

Stap 3: Voeg de JSON-body toe

Ga naar het tabblad Body, selecteer raw en kies JSON uit het dropdown-menu rechts. Vul de JSON in:

```json { "email": "nieuw@voorbeeld.be" } ```

Stap 4: Verstuur en bekijk de response

Klik op Send. Postman toont de statuscode, response body en headers onderaan. Controleer of je 200 of 204 terugkrijgt.

Stap 5: Bewaar het verzoek in een collectie

Klik op Save en voeg het verzoek toe aan een collectie. Zo kun je de test later herhalen zonder alles opnieuw in te typen.

Veelvoorkomende fouten en hoe je ze oplost

405 Method Not Allowed: je endpoint ondersteunt PATCH niet. Controleer je API-routes en zorg dat de PATCH-methode expliciet is toegestaan.

415 Unsupported Media Type: de Content-Type header ontbreekt of is verkeerd. Zet deze op application/json.

422 Unprocessable Entity: de data voldoet niet aan de validatieregels. Lees de foutmelding in de response body om te zien welk veld het probleem veroorzaakt.

500 Internal Server Error: er gaat iets fout in je backend-code. Check de serverlogs om de oorzaak te achterhalen.

Zelf-scan: is jouw PATCH-implementatie productierijp?

Doorloop deze checklist voordat je je API live zet:

• [ ] PATCH wijzigt alleen de meegegeven velden, niet het hele object
• [ ] Een PATCH met een leeg object of zonder wijzigingen geeft een logische response (200 of 400)
• [ ] Verplichte velden worden gevalideerd en geven een duidelijke foutmelding bij ontbreken
• [ ] Authenticatie en autorisatie worden correct afgedwongen
• [ ] De response bevat het bijgewerkte object of een duidelijke bevestiging
• [ ] Een PATCH op een niet-bestaand ID geeft 404 Not Found terug
• [ ] Je API-documentatie beschrijft welke velden patchbaar zijn en welke niet

Hulpmiddelen die je vandaag kunt gebruiken

Je hebt geen betaalde tools nodig om PATCH-verzoeken te testen. Gebruik:

• cURL (ingebouwd in Linux, macOS, Windows 10 en hoger)
• Postman (gratis download via postman.com)
• HTTPie (een gebruiksvriendelijker alternatief voor cURL, te installeren via httpie.io)
• De Network-tab in je browser Developer Tools (F12) om te zien welke verzoeken je frontend verstuurt

Wil je geautomatiseerde tests opzetten, kijk dan naar Jest met node-fetch voor Node.js, of pytest met requests voor Python. De officiële documentatie van deze tools staat op npmjs.com en docs.pytest.org.

Wanneer HisarWeb kan bijspringen

Dit stappenplan helpt je om zelf PATCH-verzoeken te testen en veelvoorkomende problemen op te lossen. Loop je vast bij het opzetten van je API, validatielogica of geautomatiseerde tests, of kost het te veel tijd om het zelf uit te zoeken, dan kan HisarWeb meekijken. We helpen KMO's in de Benelux met maatwerk-API's en backend-integraties die gewoon werken.