В чем разница между выполнением десяти запросов PUT и POST?

# Разница между десятью PUT и десятью POST запросами

Хотя оба метода отправляют данные на сервер, между ними есть фундаментальная разница в идемпотентности и семантике.

Определение методов

POST (Non-Idempotent)

• Назначение: создать новый ресурс
• Результат: каждый запрос создаёт новый ресурс
• Идемпотентный? НЕТ

PUT (Idempotent)

• Назначение: заменить/обновить существующий ресурс
• Результат: каждый запрос перезаписывает ресурс теми же данными
• Идемпотентный? ДА

Практический пример

Десять POST запросов

POST /api/users
Body: {"name": "Alice", "email": "alice@test.com"}

Запрос 1: Создан User ID=1
Запрос 2: Создан User ID=2
Запрос 3: Создан User ID=3
...
Запрос 10: Создан User ID=10

Результат: 10 разных пользователей!

Десять PUT запросов

PUT /api/users/1
Body: {"name": "Alice", "email": "alice@test.com"}

Запрос 1: User ID=1 обновлён
Запрос 2: User ID=1 обновлён (теми же данными)
Запрос 3: User ID=1 обновлён (теми же данными)
...
Запрос 10: User ID=1 обновлён (теми же данными)

Результат: 1 пользователь с одинаковым состоянием!

Что такое Идемпотентность?

Идемпотентность — это свойство операции, при котором выполнение её один раз и несколько раз дает одинаковый результат.

Математический пример:
Идемпотентно: x = 5; x = 5; x = 5; (всегда x = 5)
Не идемпотентно: x = x + 1; (x = 1, 2, 3, ...)

Таблица сравнения

Примеры кода

Python requests

import requests

# POST: создаём 10 разных пользователей
for i in range(10):
    response = requests.post(
        "https://api.example.com/api/users",
        json={"name": f"User{i}", "email": f"user{i}@test.com"}
    )
    print(response.json())  # ID: 1, 2, 3, ..., 10

# PUT: обновляем одного пользователя 10 раз
for i in range(10):
    response = requests.put(
        "https://api.example.com/api/users/1",
        json={"name": "Alice", "email": "alice@test.com"}
    )
    print(response.json())  # Всегда ID: 1, данные одинаковые

Практические последствия

При сетевых ошибках

POST с retry:

Запрос 1: Тайм-аут ❌
Retry:
Запрос 2: OK, создан User ID=1 ✓
Запрос 3: OK, создан User ID=2 ✓ ← Дублирование!

PUT с retry:

Запрос 1: Тайм-аут ❌
Retry:
Запрос 2: OK, User ID=1 обновлён ✓
Запрос 3: OK, User ID=1 обновлён ✓ ← Безопасный retry

В CI/CD (тестирование)

POST — проблема:

def test_create_user():
    response = requests.post("/api/users", json={"name": "Alice"})
    # Если тест упадёт и перезапуститься — создаст 2 пользователей!

PUT — решение:

def test_update_user():
    response = requests.put("/api/users/1", json={"name": "Alice"})
    # Если перезапуститься — обновит того же пользователя

Safe и Idempotent методы HTTP

| Метод | Safe | Idempotent |
|-------|------|------------|
| GET   | ДА   | ДА        |
| HEAD  | ДА   | ДА        |
| POST  | НЕТ  | НЕТ       |
| PUT   | НЕТ  | ДА        |
| DELETE| НЕТ  | ДА        |
| PATCH | НЕТ  | НЕТ       |

Safe = не изменяет состояние
Idempotent = может повторяться безопасно

PATCH — промежуточный вариант

PUT — заменяет весь ресурс

PUT /api/users/1
{"name": "Alice", "email": "alice@new.com", "age": 25}

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

PATCH /api/users/1
{"name": "Alice"}  ← Только это изменится, остальное останется

Заключение

Десять PUT запросов результируют в 1 ресурс с одинаковым состоянием. Десять POST запросов результируют в 10 разных ресурсов.

Это различие критично для:

• Обработки сетевых ошибок (retry logic)
• Тестирования (idempotent тесты)
• API дизайна (правильный выбор метода)