In http rest APIs we are stuck with a very limited set of verbs. They are essentially:
- get: to load data
- post: to create new data
- put: to replace data
- patch: to update data
- delete: to remove data
These are the verbs of a typical crud operation. They are very effective. But let me tell you a story:
In the afternoon you patch your location to your mothers house. After that you get her data and patch her status to Happy.
This is a small situation as if you tell a story to a database. Here is the same story, but for the application layer:
In the afternoon you drive into the city to your mothers house. After you see her, you notice her pretty dress. You make her a nice compliment. That makes her very happy.
What version of the story do you prefer?