restcookbook.com

Wanneer moeten we PUT gebruiken en wanneer moeten we POST gebruiken?

de HTTP methoden POST en PUT zijn niet het HTTP equivalent van de CRUD ‘ s create en update. Ze hebben allebei een ander doel. Het is heel goed mogelijk, geldig en zelfs de voorkeur in sommige gevallen, om PUT te gebruiken om bronnen te creëren, of gebruik POST OM bronnen bij te werken.

gebruik PUT wanneer u een bron volledig kunt bijwerken via een specifieke bron. Als u bijvoorbeeld weet dat een artikel zich bevindt op http://example.org/article/1234, kunt u een nieuwe bronrepresentatie van dit artikel direct plaatsen via een PUT op deze URL.

als u de werkelijke bronlocatie niet weet, bijvoorbeeld wanneer u een nieuw artikel toevoegt, maar geen idee hebt waar het moet worden opgeslagen, kunt u het op een URL plaatsen en de server de werkelijke URL laten bepalen.

PUT /article/1234 HTTP/1.1<article> <title>red stapler</title> <price currency="eur">12.50</price></article>

POST /articles HTTP/1.1<article> <title>blue stapler</title> <price currency="eur">7.50</price></article>HTTP/1.1 201 CreatedLocation: /articles/63636

zodra u kent de nieuwe bron locatie, U kunt opnieuw gebruiken om updates te doen voor de blauwe nietmachine artikel. Maar zoals eerder gezegd: Je kunt ook nieuwe bronnen toevoegen via PUT. Het volgende voorbeeld is perfect geldig als uw API deze functionaliteit biedt:

PUT /articles/green-stapler HTTP/1.1<article> <title>green stapler</title> <price currency="eur">9.95</price></article>HTTP/1.1 201 CreatedLocation: /articles/green-stapler