Using http methods to define actions:
- GET: Retrieve data.
- POST: Create new resources.
- PUT, PATCH: Update existing resources.
- DELETE: Remove resources.
Using plural nouns for resources collections:
Example: to create new user, use POST api.example.com/users
Organize resources into a hierarchical structure
Example:
- Retrieve user by ID (e.g. ID 5): GET api.example.com/users/5
- Retrieve user's skills (ID 5): GET api.example.com/users/5/skills
Use query parameters for operations like filtering, sorting and pagination
Example: GET api.example.com/users?sort=desc&limit=25&offset=50
- sort=desc: Sort results in descending order.
- limit=25: Limit the results to 25 items.
- offset=50: Skip the first 50 results.

APIs should accept and return data in JSON format for consistency and ease of use

TakeNoteX

References: