restcookbook.com

NÅR skal VI BRUKE PUT og NÅR skal VI BRUKE POST?

HTTP-metodene POST og PUT er IKKE HTTP-ekvivalenten TIL CRUDS opprett og oppdater. Begge tjener et annet formål. DET er ganske mulig, gyldig og til og med foretrukket i noen anledninger, å bruke PUT til å lage ressurser, eller bruke POST til å oppdatere ressurser.

Bruk PUT når du kan oppdatere en ressurs helt gjennom en bestemt ressurs. For eksempel, hvis du vet at en artikkel ligger på http://example.org/article/1234, kan du SETTE en ny ressursrepresentasjon av denne artikkelen direkte gjennom ET SETT på DENNE NETTADRESSEN.

hvis du ikke vet den faktiske ressursplasseringen, for eksempel når du legger til en ny artikkel, men ikke har noen anelse om hvor du skal lagre den, KAN DU LEGGE DEN TIL EN URL, og la serveren bestemme den faktiske URL.

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

så snart du kjenner den nye ressursplasseringen, kan du bruke put again til å gjøre oppdateringer til den blå stifteartikkelen. Men som sagt før: du kan legge til nye ressurser GJENNOM PUT også. Det neste eksemplet er helt gyldig hvis API-EN din gir denne funksjonaliteten:

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