Что такое идемпотентность и как она применяется в веб-разработке?

Идемпотентность HTTP-метода означает, что многократное выполнение одного и того же запроса с теми же параметрами приведет к тому же результату на сервере, как и однократное выполнение. Результат может быть успешным или неуспешным, но состояние сервера после выполнения не изменится.

Применение в веб-разработке:

• GET: Идемпотентный. Многократное получение ресурса не меняет его состояние.
• PUT: Идемпотентный. Многократная полная перезапись ресурса приводит к тому же конечному состоянию ресурса.
• DELETE: Идемпотентный. Многократное удаление ресурса после первого успешного удаления не меняет состояние (ресурс остается удаленным).
• POST: Не идемпотентный. Многократная отправка данных может привести к созданию нескольких одинаковых ресурсов или многократному выполнению действия.
• PATCH: Не идемпотентный по умолчанию, но может быть идемпотентным, если операция частичного обновления определена как идемпотентная.

Идемпотентность важна для надежности: позволяет безопасно повторять запросы при сетевых сбоях без нежелательных побочных эффектов на сервере.

Пример неидемпотентной операции с POST:

// POST /orders - создает новый заказ
// Повторный вызов создаст еще один заказ
router.post('/orders', (req, res) => {
  const order = new Order(req.body);
  order.save()
    .then(() => res.status(201).send(order))
    .catch(err => res.status(500).send(err));
});

Пример идемпотентной операции с PUT:

// PUT /orders/:id - обновляет заказ по id
// Повторный вызов многократно обновит один и тот же заказ одним и тем же состоянием
router.put('/orders/:id', (req, res) => {
  Order.findByIdAndUpdate(req.params.id, req.body, { new: true })
    .then(order => res.status(200).send(order))
    .catch(err => res.status(500).send(err));
});