PrepBro
← Назад к вопросам

Для чего используют PUT?

1.6 Junior🔥 241 комментариев
#API и интеграции

Комментарии (1)

🐱
claude-haiku-4.5PrepBro AI28 мар. 2026 г.(ред.)

Ответ сгенерирован нейросетью и может содержать ошибки

HTTP метод PUT и его применение

PUT - это HTTP метод для обновления или замены существующего ресурса на сервере. Это одна из основных операций REST API, используемая для изменения состояния ресурса. PUT является частью CRUD операций (Create, Read, Update, Delete).

Основное назначение PUT

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

Синтаксис PUT запроса:

PUT /api/v1/users/{id}
Content-Type: application/json

{
  "id": 123,
  "name": "John Doe",
  "email": "john@example.com",
  "age": 30,
  "city": "New York"
}

В этом примере весь пользователь с ID 123 заменяется новыми данными. Все поля заменяются полностью.

Ключевые характеристики PUT

Идемпотентность - это главное свойство PUT. Если отправить один и тот же PUT запрос несколько раз, результат будет одинаковым. Сервер не будет создавать дубликаты или неожиданные изменения. Например:

1-й запрос: PUT /users/123 -> обновляет пользователя
2-й запрос: PUT /users/123 -> обновляет тем же данным (нет изменений)
3-й запрос: PUT /users/123 -> обновляет тем же данным (нет изменений)

Полное обновление (Replace) - PUT заменяет весь ресурс. Если отправить:

{
  "name": "Jane Doe"
}

То все остальные поля могут быть удалены или установлены в null (в зависимости от реализации).

Требует ID ресурса - PUT всегда должен включать ID или полный путь к конкретному ресурсу, который обновляется.

Различие между PUT и PATCH

Это критически важное различие для system analyst:

PUT - полное обновление:

Исходный ресурс:
{
  "id": 1,
  "name": "John",
  "email": "john@example.com",
  "phone": "123-456"
}

PUT запрос (отправляем только name и email):
{
  "name": "Jane",
  "email": "jane@example.com"
}

Результат:
{
  "id": 1,
  "name": "Jane",
  "email": "jane@example.com",
  "phone": null или поле удалено
}

Все остальные поля могут быть потеряны!

PATCH - частичное обновление:

Исходный ресурс:
{
  "id": 1,
  "name": "John",
  "email": "john@example.com",
  "phone": "123-456"
}

PATCH запрос (отправляем только name и email):
{
  "name": "Jane",
  "email": "jane@example.com"
}

Результат:
{
  "id": 1,
  "name": "Jane",
  "email": "jane@example.com",
  "phone": "123-456"
}

Остальные поля остаются без изменений!

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

Обновление профиля пользователя:

PUT /api/v1/users/42
Content-Type: application/json

{
  "username": "johndoe",
  "email": "john@example.com",
  "first_name": "John",
  "last_name": "Doe",
  "age": 30,
  "bio": "Software developer",
  "avatar_url": "https://example.com/avatar.jpg"
}

Это полностью заменит профиль пользователя с ID 42.

Обновление продукта в каталоге:

PUT /api/v1/products/999
Content-Type: application/json

{
  "name": "Laptop",
  "price": 999.99,
  "description": "High-performance laptop",
  "stock": 50,
  "category": "Electronics",
  "sku": "LAPTOP-001"
}

Обновление статуса заказа:

PUT /api/v1/orders/ORD-12345
Content-Type: application/json

{
  "status": "shipped",
  "tracking_number": "TRK123456",
  "carrier": "FedEx",
  "estimated_delivery": "2026-04-05"
}

Коды ответов при PUT

200 OK - ресурс успешно обновлен, тело ответа содержит обновленный ресурс.

201 Created - ресурс был создан (если сервер позволяет создавать PUT запросом).

204 No Content - ресурс успешно обновлен, но нет содержимого в ответе.

400 Bad Request - неправильный формат данных или валидация не пройдена.

401 Unauthorized - требуется аутентификация.

403 Forbidden - у пользователя нет прав на обновление ресурса.

404 Not Found - ресурс не найден.

409 Conflict - конфликт версий (используется для оптимистичной блокировки).

REST методы CRUD таблица

ОперацияHTTP методURLТело
CreatePOST/api/v1/users{name, email, ...}
ReadGET/api/v1/users/{id}-
Update (полное)PUT/api/v1/users/{id}{name, email, ...}
Update (частичное)PATCH/api/v1/users/{id}{name}
DeleteDELETE/api/v1/users/{id}-

Лучшие практики для PUT

Всегда отправляй полный ресурс - если используешь PUT, отправляй все поля ресурса, даже если они не меняются. Это предотвращает потерю данных.

Используй версионирование - для предотвращения конфликтов при одновременном обновлении, используй механизм версионирования (ETag, version field):

{
  "id": 1,
  "name": "John",
  "version": 5
}

Validation на сервере - всегда валидируй данные на сервере перед сохранением.

Логирование - логируй все PUT операции для аудита и отладки.

Права доступа - убедись, что пользователь имеет права на обновление этого ресурса (проверка владельца, роли и т.д.).

Когда использовать PUT vs PATCH

Используй PUT когда:

  • Нужно полностью заменить ресурс
  • Клиент отправляет все поля ресурса
  • Идемпотентность критична
  • Простота важнее гибкости

Используй PATCH когда:

  • Нужно обновить только часть ресурса
  • Клиент отправляет только измененные поля
  • Хочешь экономить трафик
  • Нужна гибкость в обновлении

Реальные примеры API

GitHub API - использует PATCH для частичного обновления.

Stripe API - использует POST для обновления (нестандартно).

JSONPlaceholder - использует PUT для полного обновления.

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