Idempotent

HTTP-methode PUT

PUT-requests vervangen de doelresource door de requestinhoud.

Betekenis

De client vraagt de server om de meegestuurde representatie op te slaan onder de doel-URI.

Gebruik PUT wanneer de client een bekende resource vervangt of naar een bekende URL schrijft.

Controleer of de request de volledige vervangende representatie bevat en of preconditieheaders onbedoeld overschrijven voorkomen wanneer nodig.

PUT /articles/123 HTTP/1.1
Host: example.com
Content-Type: application/json

{"title":"Updated article"}

Veilig: Nee. Deze methode kan de serverstatus wijzigen.
Idempotent: Ja. Dezelfde request herhalen hoort hetzelfde beoogde effect te hebben.
Cachebaar: Nee
Requestbody: Meestal wel