Основные HTTP-методы определяют тип действия, которое клиент хочет выполнить с ресурсом на сервере. Вот ключевые:
Назначение: Получение ресурса с сервера.
Особенности:
Безопасный и идемпотентный (не изменяет данные).
Может содержать параметры в URL (query string).
query string
Пример: GET /users/123 — получить пользователя с ID 123.
GET /users/123
Назначение: Создание нового ресурса на сервере.
Не идемпотентный (каждый вызов создаёт новый ресурс).
Данные передаются в теле запроса (JSON, form-data).
Пример: POST /users с телом { "name": "John" } — создать нового пользователя.
POST /users
{ "name": "John" }
Назначение: Полное обновление существующего ресурса.
Идемпотентный (несколько одинаковых запросов дают один результат).
Тело запроса содержит полный объект.
Пример: PUT /users/123 с телом { "name": "John", "active": true } — обновить все поля пользователя.
PUT /users/123
{ "name": "John", "active": true }
Назначение: Частичное обновление ресурса.
Идемпотентный.
Тело запроса содержит только изменяемые поля.
Пример: PATCH /users/123 с телом { "active": false } — изменить только статус активности.
PATCH /users/123
{ "active": false }
Назначение: Удаление ресурса.
Пример: DELETE /users/123 — удалить пользователя с ID 123.
DELETE /users/123
HEAD — как GET, но возвращает только заголовки без тела.
OPTIONS — возвращает допустимые методы для ресурса (CORS и проверка).
CONNECT — устанавливает туннель (например, для HTTPS через прокси).
TRACE — возвращает путь запроса для отладки.
Last updated 4 months ago