Use Verbs
Use the verbs specified for the HTTP protocol to get the most our of you HTTP based API.
The verbs are more correctly named: HTTP request methods and the term verbs is also widely used.
POSTfor creationGETfor readingPUTfor complete updating or replacingPATCHfor partial updating or modifyingDELETEfor deletion
If you, like me cannot remember, which of the verbs does what, like POST, PUT and PATCH you can use these simple rules of thumb, the first one I got from a colleague:
The
UinPUTis for update
And now for one I had to make for myself:
Post is always delivered at the gate, so when thinking about
POST, remember gate rhymes with create…
And the last one is for PATCH, if you are RESTful
PATCHcan do a partial update compared toPUTso “PAT” is short for partial…