lightmy.day

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

Gerelateerde HTTP-methoden

Gerelateerde HTTP-statuscodes