REST API — did you design them from scratch, modify existing methods, or were you provided with ready-made contracts and worked according to them?

In my practice, I have experience designing REST APIs from scratch, refining existing methods, and working with ready-made contracts.

When designing from scratch, I usually start by defining resources and their relationships, planning the URL structure, HTTP methods (GET, POST, PUT, DELETE), and data formats (JSON). It is important to ensure the API is understandable and predictable so that clients find it easy to work with.

When modifying existing methods, I try to maintain backward compatibility or document changes to avoid breaking integrations.

When working with ready-made contracts, I focus on implementation according to the specifications, testing, and ensuring the correctness of responses and error handling.

An example of a simple REST API for task management:

GET /tasks          # get list of tasks
POST /tasks         # create a new task
GET /tasks/{id}     # get a task by id
PUT /tasks/{id}     # update a task
DELETE /tasks/{id}  # delete a task

Each method should return the appropriate HTTP codes and data in JSON.