Statuswijzigend
HTTP-methode PATCH
PATCH-requests passen gedeeltelijke wijzigingen toe op een resource.
Betekenis
De client verstuurt een wijzigingsdocument dat de doelresource gedeeltelijk aanpast.
Veelvoorkomend gebruik
Gebruik PATCH wanneer slechts een deel van een resource moet wijzigen en de server het patchdocumentformaat ondersteunt.
Wat te controleren
Controleer het patch-mediatype, Accept-Patch-ondersteuning, validatiefouten en conflict- of preconditieresponsen.
Voorbeeldrequest
PATCH /articles/123 HTTP/1.1
Host: example.com
Content-Type: application/merge-patch+json
{"title":"Updated title"}Eigenschappen
- Veilig
- Nee. Deze methode kan de serverstatus wijzigen.
- Idempotent
- Nee. De request herhalen kan een extra effect veroorzaken.
- Cachebaar
- Alleen wanneer de respons dit expliciet toestaat.
- Requestbody
- Meestal wel
Referenties
- Register
- IANA HTTP Method Registry
- Gids
- MDN PATCH