HTTP-методы и статус-коды

Около 7 мин чтения

Раздел: 06 — Основы API Уровень: Начинающий

HTTP-методы

HTTP-методы определяют, какое действие клиент хочет выполнить с ресурсом. В REST API каждый метод имеет чёткую семантику.

Обзор методов

Метод	Назначение	Идемпотентность	Безопасность
GET	Получить данные	Да	Да
POST	Создать ресурс	Нет	Нет
PUT	Заменить ресурс целиком

GET /api/users/42 HTTP/1.1
Host: example.com
Accept: application/json

{
  "id": 42,
  "name": "Иван",
  "email": "ivan@example.com"
}

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

{
  "name": "Мария",
  "email": "maria@example.com",
  "role": "admin"
}

{
  "id": 43,
  "name": "Мария",
  "email": "maria@example.com",
  "role": "admin",
  "created_at": "2026-01-15T10:30:00Z"
}

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

{
  "name": "Иван Петров",
  "email": "ivan.petrov@example.com",
  "role": "user"
}

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

{
  "email": "new.ivan@example.com"
}

{
  "id": 42,
  "name": "Иван",
  "email": "new.ivan@example.com",
  "role": "admin"
}

DELETE /api/users/42 HTTP/1.1
Host: example.com
Authorization: Bearer token123

Код	Название	Описание	Когда используется
200	OK	Успешный запрос	GET, PUT, PATCH
201	Created	Ресурс создан	POST
204	No Content	Успех без тела ответа	DELETE
202	Accepted	Запрос принят, обработка позже	Асинхронные операции

GET /users/42     → 200 OK (+ данные)
POST /users       → 201 Created (+ созданный объект)
PATCH /users/42   → 200 OK (+ обновлённый объект)
DELETE /users/42  → 204 No Content

Код	Название	Описание
301	Moved Permanently	Ресурс перемещён навсегда
302	Found	Временное перенаправление
304	Not Modified	Данные не изменились (кэш актуален)

Код	Название	Описание	Типичная ситуация
400	Bad Request	Неверный запрос	Невалидный JSON, отсутствует обязательное поле
401	Unauthorized	Не авторизован	Нет токена или токен невалидный
403	Forbidden	Доступ запрещён	Токен валидный, но прав не хватает
404	Not Found	Не найден	Несуществующий endpoint или ресурс
405	Method Not Allowed	Метод не поддерживается	POST на endpoint, который принимает только GET
409	Conflict	Конфликт	Дублирование данных (такой email уже есть)
422	Unprocessable Entity	Ошибка валидации	Данные не прошли бизнес-валидацию
429	Too Many Requests	Слишком много запросов	Rate limiting

Код	Название	Описание
500	Internal Server Error	Внутренняя ошибка сервера
502	Bad Gateway	Сервис-посредник получил неверный ответ
503	Service Unavailable	Сервер временно недоступен
504	Gateway Timeout	Сервис-посредник не дождался ответа

Заголовок	Назначение	Пример
`Content-Type`	Формат тела запроса	`application/json`
`Accept`	Желаемый формат ответа	`application/json`
`Authorization`	Данные авторизации	`Bearer eyJhbG...`
`User-Agent`	Информация о клиенте	`Mozilla/5.0...`
`Cache-Control`	Правила кэширования	`no-cache`

Заголовок	Назначение	Пример
`Content-Type`	Формат тела ответа	`application/json; charset=utf-8`
`Content-Length`	Размер тела в байтах	`256`
`Cache-Control`	Правила кэширования	`max-age=3600`
`X-RateLimit-Remaining`	Оставшиеся запросы	`95`
`Set-Cookie`	Установка cookie	`session=abc123; HttpOnly`

{
  "title": "Баг-репорт",
  "description": "Кнопка не работает",
  "priority": "high",
  "assignee_id": 5
}

{
  "error": {
    "code": 422,
    "message": "Validation failed",
    "details": [
      {
        "field": "email",
        "message": "Invalid email format"
      }
    ]
  }
}

Метод	Типичные коды успеха	Типичные коды ошибки
GET	200, 304	404, 401, 403
POST	201, 200	400, 409, 422
PUT	200, 204	400, 404, 422
PATCH	200	400, 404, 422
DELETE	204, 200	404, 403

HTTP-методы и статус-коды

HTTP-методы

Обзор методов

GET — Получение данных

POST — Создание ресурса

PUT — Полная замена ресурса

PATCH — Частичное обновление

DELETE — Удаление ресурса

Статус-коды HTTP

2xx — Успешно

3xx — Перенаправление

4xx — Ошибка клиента

5xx — Ошибка сервера

HTTP-заголовки (Headers)

Основные заголовки запроса

Основные заголовки ответа

Тело запроса и ответа (Body)

Когда тело ОБЯЗАТЕЛЬНО:

Когда тела НЕТ:

Пример тела запроса (POST):

Пример тела ответа (ошибка):

Сводная таблица: метод + код ответа

Ключевые выводы

Ссылки