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

А, идемпотентность! Ну это, блядь, классика, про которую каждый второй джуниор на собеседовании нихуя не может внятно объяснить, а потом удивляется, почему его API нихуя не работает как надо.

Смотри, представь себе, ты в баре. Ты подходишь к бармену и говоришь: «Дай мне пива». Это GET. Ты можешь просить его хоть десять раз — ты получишь информацию о пиве (или само пиво), но новый бокал с каждым разом не появится. Состояние бара — нихуя не изменилось. Идемпотентно.

А теперь ты говоришь: «Слушай, на столе №5 поставь бутылку виски и две рюмки». Это PUT. Ты полностью заменяешь то, что было на столе №5. Ты можешь повторить эту команду ещё раз — на столе всё равно будет бутылка виски и две рюмки, а не четыре. Конечное состояние — одинаковое. Тоже идемпотентно.

Дальше — DELETE. Ты говоришь: «Убери со стола №5 эту бутылку». Её убрали. Ты, обдолбанный, через пять минут орёшь то же самое. Бармен говорит: «Бля, да её уже нет, че ты доёбываешься?». Состояние системы — бутылки нет — нихуя не изменилось. Идемпотентно.

А вот POST — это пиздец. Это когда ты говоришь: «Сделай мне ещё один такой же коктейль». Каждый раз, когда ты это говоришь, бармен нихуя делает новый коктейль, и счёт твой растёт, как сумасшедший. Состояние системы (твой счёт и количество коктейлей в мире) меняется каждый раз. Это нихуя не идемпотентно. Вот почему для POST нужны ключи идемпотентности — чтобы бармен, если ты повторил запрос из-за того, что просто не услышал ответ в шуме, не наделал тебе овердохуища одинаковых коктейлей.

С PATCH вообще цирк. Если ты говоришь: «На столе №5 поставь соль на место перца» — это может быть идемпотентно. Но если ты скажешь: «Долей в мой стакан ещё 50 мл», то каждый повтор запроса нихуя добавит тебе ещё. И стакан, блядь, потечёт. Поэтому PATCH по умолчанию считаем неидемпотентным, иначе сам себе злой буратино.

Зачем это всё, ёпта? Представь, твой клиент отправил запрос на удаление юзера, а соединение нихуя проёбано. Клиент не получил ответ 200 OK и думает: «Бля, не удалилось». Он шлёт запрос ещё раз. Если DELETE идемпотентный — нихуя не страшно. Юзер уже удалён, система в том же состоянии. А если бы это был POST на списание денег — вот тут бы началась настоящая хитрая жопа. Деньги спишутся дважды, и будет тебе, чувак, хиросима и нигерсраки в бухгалтерии.

Вот смотри на код, тут нихуя не трогаем:

// Идемпотентные методы — повторяй, не бойся (в разумных пределах, естественно)
app.put('/api/wallet/:id', (req, res) => {
  // Установит баланс в N рублей. Вызови 100 раз — баланс всё равно будет N.
  updateWallet(req.params.id, { balance: req.body.balance });
  res.sendStatus(200);
});

app.delete('/api/cart/:itemId', (req, res) => {
  // Удалит товар. Вызови ещё раз — товара уже нет, но состояние корзины не изменится.
  removeItemFromCart(req.params.itemId);
  res.sendStatus(200); // или 404, если уже удалён — состояние-то одинаковое!
});

// НЕ идемпотентный метод — опасность, блядь!
app.post('/api/orders', (req, res) => {
  // Каждый вызов создаст НОВЫЙ заказ. Клиент отправил запрос 3 раза из-за таймаута?
  // Получай три одинаковых заказа и **терпения ноль ебать**.
  const newOrder = createOrder(req.body);
  res.status(201).json(newOrder);
});

Так что запомни, чувак: идемпотентность — это про то, чтобы итоговое состояние сервера после кучи одинаковых запросов было таким же, как и после одного. Не путай это с кодом ответа. После первого удаления может прийти 200, а после второго — 404, но ресурса-то в итоге нихуя нет в обоих случаях. Вот и вся магия. Э бошка думай, когда методы выбираешь.