URL design

Good URL design names resources (nouns, in the plural) rather than actions, expresses hierarchy through the path, and leaves the verbs to the HTTP methods. URLs are stable, readable, and consistent across the whole API.

Example

GET /clients/12/commandes (and not /getCommandesClient?id=12)

Related concepts

The whole glossary