API Design Principles
Design APIs that are intuitive, consistent, and a joy to use.
URL Structure
Resources as Nouns
# GOOD - nouns
GET /users
GET /users/123
GET /users/123/orders
# BAD - verbs
GET /getUsers
GET /fetchUserById/123
POST /createNewUserPlural Resource Names
# GOOD - plural
GET /users
GET /orders
GET /products
# BAD - singular
GET /user
GET /orderHierarchical Relationships
# Parent-child relationships
GET /users/123/orders # Ord
[Description truncada. Veja o README completo no GitHub.]