search

seekingmeanings / scoreboard

GNU General Public License v3.0
0 stars 0 forks source link

Correct http verbs #8

Open seekingmeanings opened 4 months ago

seekingmeanings commented 4 months ago

Change some post to put

seekingmeanings commented 4 months ago

PUT implies putting a resource - completely replacing whatever is available at the given URL with a different thing. By definition, a PUT is idempotent. Do it as many times as you like, and the result is the same. x=5 is idempotent. You can PUT a resource whether it previously exists, or not (eg, to Create, or to Update)!

POST updates a resource, adds a subsidiary resource, or causes a change. A POST is not idempotent, in the way that x++ is not idempotent.

You have to ask, "what are you performing the action upon?", to distinguish what you should be using. Let's assume you're designing an API for asking questions. If you want to use POST, then you would do that to a list of questions. If you want to use PUT, then you would do that to a particular question.