restcookbook.com

milloin kannattaa käyttää PUT-valmistetta ja milloin postia?

HTTP-menetelmät POST ja PUT eivät ole HTTP-vastine CRUDIN luomiselle ja päivitykselle. Molemmat palvelevat eri tarkoitusta. On täysin mahdollista, voimassa ja jopa edullista joissakin tilanteissa, käyttää PUT luoda resursseja, tai käyttää POST päivittää resursseja.

käytä PUT-sovellusta, kun voit päivittää resurssin kokonaan tietyn resurssin kautta. Esimerkiksi, jos tiedät, että artikkeli asuu http://example.org/article/1234, voit laittaa uuden resurssiesityksen tästä artikkelista suoraan tämän URL-osoitteen kautta.

Jos et tiedä todellista resurssin sijaintia, esimerkiksi kun lisäät uuden artikkelin, mutta sinulla ei ole aavistustakaan, minne tallentaa se, voit lähettää sen URL-osoitteeseen ja antaa palvelimen päättää todellisen URL-osoitteen.

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

heti kun tiedät uuden resurssin sijainnin, voit käyttää put againia tekemään päivityksiä Blue nitoja-artikkeliin. Mutta kuten sanottu aiemmin: voit lisätä uusia resursseja PUT samoin. Seuraava esimerkki on täysin pätevä, jos API tarjoaa tämän toiminnallisuuden:

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