Какие есть методы в REST API?

Методы HTTP в REST API

В REST API используются стандартные методы протокола HTTP, которые также называются HTTP-глаголами (HTTP verbs). Эти методы определяют тип операции, которую клиент хочет выполнить над ресурсом, идентифицируемым URI. Основные методы соответствуют операциям CRUD (Create, Read, Update, Delete) и следуют принципам идемпотентности и безопасности.

Основные методы (CRUD-операции)

1. GET

Используется для чтения или получения данных о ресурсе. Это безопасный и идемпотентный метод.

• Назначение: Получить представление ресурса.
• Идемпотентность: Да (многократные идентичные запросы дают один результат).
• Безопасность: Да (не изменяет состояние сервера).
• Тело запроса: Обычно отсутствует.
• Тело ответа: Содержит данные запрошенного ресурса.
• Коды ответа: 200 OK, 404 Not Found, 304 Not Modified.

GET /api/users/123 HTTP/1.1
Host: example.com

2. POST

Используется для создания нового ресурса или выполнения нестандартных действий. Не является ни идемпотентным, ни безопасным.

• Назначение: Создать новый ресурс, часто данные для создания передаются в теле запроса.
• Идемпотентность: Нет (повторный запрос создаст ещё один ресурс).
• Безопасность: Нет.
• Тело запроса: Содержит данные нового ресурса (например, JSON).
• Тело ответа: Часто содержит данные созданного ресурса, включая новый ID.
• Коды ответа: 201 Created, 400 Bad Request.

POST /api/users HTTP/1.1
Host: example.com
Content-Type: application/json

{
  "name": "Ivan",
  "email": "ivan@example.com"
}

3. PUT

Используется для полного обновления существующего ресурса или его создания, если он не существует. Метод идемпотентный.

• Назначение: Заменить ресурс целиком данными из тела запроса.
• Идемпотентность: Да (многократное повторение обновления даст тот же результат, что и одно).
• Безопасность: Нет.
• Тело запроса: Содержит полное новое представление ресурса.
• Коды ответа: 200 OK, 204 No Content, 201 Created (если создан), 404 Not Found.

PUT /api/users/123 HTTP/1.1
Host: example.com
Content-Type: application/json

{
  "name": "Ivan Petrov",
  "email": "ivan.p@example.com"
}

4. PATCH

Используется для **частичного