Defining your endpoints and responding to requests in your RESTful API

Fourth article in the series of “Pragmatic decisions for your RESTful API”, this post talks about how to define your endpoints and how you should respond to GET, POST, PUT and PATCH requests in your RESTful API.

Defining your endpoints: use plural

Your endpoints should be defined using plural, not singular, as it will avoid odd pluralization (such as person/people, country/countries etc…). For users, for example, this is the list of endpoints you could have: