Какие HTTP-методы используются в REST API и в чем их назначение?

REST API использует стандартные HTTP-методы для выполнения операций над ресурсами, что делает интерфейс предсказуемым и соответствует принципу единообразного интерфейса. Каждый метод имеет строго определённую семантику, которую клиенты и серверы должны соблюдать для корректной работы.

Основные методы и их назначение

• GET: Запрашивает представление ресурса. Должен быть безопасным (не изменять состояние сервера) и идемпотентным (повторные запросы дают тот же результат). Используется для чтения данных.
• POST: Используется для создания нового ресурса. Не является ни безопасным, ни идемпотентным. Сервер обычно назначает новый URI для созданного ресурса.
• PUT: Используется для полного обновления ресурса по известному URI. Если ресурс не существует, он может быть создан. Метод идемпотентен.
• DELETE: Удаляет ресурс по указанному URI. Метод идемпотентен.
• PATCH: Применяется для частичного обновления ресурса. Он не является идемпотентным по умолчанию, но должен быть реализован так, чтобы повторные запросы с теми же данными давали тот же результат.

Примеры использования в коде

Рассмотрим простой пример API для управления списком задач (To-Do).

// Получить список всех задач
fetch('/api/tasks', { method: 'GET' });

// Создать новую задачу
fetch('/api/tasks', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ title: 'Новая задача' })
});

// Полностью обновить задачу с id=1
fetch('/api/tasks/1', {
  method: 'PUT',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ title: 'Обновлённая задача', completed: true })
});

// Удалить задачу с id=1
fetch('/api/tasks/1', { method: 'DELETE' });

// Частично обновить задачу с id=1 (только поле completed)
fetch('/api/tasks/1', {
  method: 'PATCH',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ completed: true })
});

Где и как применяются

Правильное использование HTTP-методов критично для создания понятных, поддерживаемых и масштабируемых API. Это позволяет разработчикам и инструментам (например, Swagger/OpenAPI) автоматически генерировать документацию и клиентские библиотеки. Соблюдение семантики методов также важно для кэширования (особенно GET-запросов) и безопасности.

Вывод: Используйте стандартные HTTP-методы (GET, POST, PUT, DELETE, PATCH) в соответствии с их семантикой для проектирования чистых и предсказуемых RESTful API. Это упрощает интеграцию, улучшает понимание API другими разработчиками и позволяет задействовать встроенные возможности HTTP, такие как кэширование.