REST API — ты проектировал их с нуля, менял существующие методы, или тебе предоставляли готовые контракты и ты по ним работал?

В моей практике было и проектирование REST API с нуля, и доработка существующих методов, и работа по готовым контрактам.

При проектировании с нуля я обычно начинаю с определения ресурсов и их отношений, продумываю структуру URL, методы HTTP (GET, POST, PUT, DELETE) и форматы данных (JSON). Важно обеспечить понятность и предсказуемость API, чтобы клиентам было удобно работать.

Если меняю существующие методы, стараюсь сохранять обратную совместимость или документировать изменения, чтобы не сломать интеграции.

При работе по готовым контрактам фокусируюсь на реализации согласно спецификации, тестировании и обеспечении корректности ответов и обработки ошибок.

Пример простого REST API для управления задачами:

GET /tasks          # получить список задач
POST /tasks         # создать новую задачу
GET /tasks/{id}     # получить задачу по id
PUT /tasks/{id}     # обновить задачу
DELETE /tasks/{id}  # удалить задачу

Каждый метод должен возвращать соответствующие HTTP-коды и данные в JSON.