PATCHverzoeken

PATCHverzoeken zijn HTTP-verzoeken die gedeeltelijke updates op een bestaande bron mogelijk maken. In tegenstelling tot PUT vervangt PATCH doorgaans niet de hele resource, maar wijzigt alleen de gespecificeerde velden. De PATCH-methode is vastgelegd in RFC 5789.

Patch-formaten: Een PATCH-document kan verschillende formaten volgen. Veelgebruikte opties zijn JSON Patch (RFC 6902) met media-type application/json-patch+json, waarin een reeks bewerkingen zoals add, remove en replace wordt beschreven, en JSON Merge Patch (RFC 7386) met media-type application/merge-patch+json, waarin een JSON-object de gewenste toestand aangeeft. Sommige API’s definiëren ook eigen patch-formaten.

Semantiek en gedrag: De patch wordt toegepast op de resource zoals bepaald door de URL. De server kan patch-operaties atomair of stapsgewijs uitvoeren. Patch is niet per definitie idempotent; dit hangt af van het patch-document en de implementatie. Voor robuuste updates worden vaak If-Match/ETag gebruikt om racecondities te voorkomen.

Gebruiksituaties: Patch is nuttig wanneer slechts enkele velden gewijzigd hoeven te worden, waardoor bandbreedte en verwerkingskosten dalen en conflicten bij gelijktijdige bewerkingen mogelijk beter beheersbaar zijn.

Aanbevelingen en kwesties: Stuur het juiste Content-Type en gebruik duidelijke foutcodes. Valideer patch-documenten op syntaxis en toegestaan gedrag. Gebruik, waar mogelijk, concurrency-controles zoals If-Match om conflicts te beperken.

Zie ook: HTTP-methoden, JSON Patch, JSON Merge Patch, RFC 5789, RFC 6902, RFC 7386.