Hands-On RESTful API Design Patterns and Best Practices

Thinking in REST

To correctly and concisely organize data in a decentralized fashion, the RESTful service paradigm comes in handy. That is, the REST concept introduces a new way to model data. There are multiple resources in any application. REST gives each participating resource a URL. Then, the recommendation is to use the standard HTTP verbs to interact with the resource. The author of the article at https://medium.com/@nathankpeck/microservice-principles-decentralized-data-management-4adaceea173f has come out with a sample API for a small social-messaging application:

There are three primitive resource types—user, message, and friend. ...