Hoe kies je tussen de methoden PUT, POST en PATCH bij het ontwerpen van een REST API?

De keuze tussen PUT, POST en PATCH hangt af van de aard van de operatie met het resource:

• POST — wordt gebruikt om een nieuw resource te creëren. Het verzoek wordt meestal naar de collectie gestuurd, en de server maakt een nieuw item aan.

• PUT — wordt gebruikt voor volledige update van het resource. De client stuurt een volledige representatie van het resource, en de server vervangt het bestaande object door deze nieuwe versie.

• PATCH — voor gedeeltelijke update van het resource. De client stuurt alleen de gewijzigde velden, en de server werkt deze bij zonder het hele object te vervangen.

Voorbeeld:

• Maak gebruiker aan — POST /users
• Werk het volledige gebruikersprofiel bij — PUT /users/{id}
• Wijzig alleen de email van de gebruiker — PATCH /users/{id}