Following up after the earlier post titled Using HTTP Status Codes correctly in your REST Web API, here is one on using the HTTP Verbs from the W3C spec in the "right way" to have a clean REST Web API. Just like the HTTP status codes, there are many more verbs in the HTTP standard that, although they are in theory OK to use for your Web API, you can get by with just a few that helps to keep your API simple, and self-explanatory to its clients.
The full list of HTTP verbs from the spec can be found HERE, but we are going to focus on how to interpret the verbs and the actions that should be executed for each on in the context of a well-defined REST Web API. In the table there is also the result set that standard clients expect when they make requests with such VERBs. To better understand their proper use, we'll use a sample resource endpoint called Users, where the (you guessed it) "Users" of our app are exposed via our Web API.
|Resource Sample||GET (aka Read)||POST (aka insert)||PUT (aka update)||DELETE (aka delete)||PATCH (aka partial update)|
|api/users||Action||Gets a list of users||Creates a user||Batch Update||Errors out||Batch Update the users only with the attributes present in the request|
|Return||List of users||New user||No payload, only HTTP Status Code||Error HTTP Status Code||No payload, only HTTP Status Code|
|api/users/123||Action||Gets a single user||Errors out||Updates the user||Deletes the user||Partially updates the user only with the attributes present in the request|
|Return||Single user||Error HTTP Status Code||Updated user||No payload, only HTTP Status Code||Updated full user object|
And this is how you properly use the HTTP Verbs in a REST Web API.