Ключ идемпотентности

Сетевой таймаут после того, как запись на самом деле прошла успешно, неотличим со стороны клиента от таймаута, при котором запрос вообще не дошёл до сервера — поэтому слепой повтор рискует создать тот же документ, коннектор или заказ дважды. Передача того же Idempotency-Key при повторе говорит API «это та же попытка»: он возвращает исходный результат вместо повторения записи.

Повторное использование ключа с другим телом запроса отклоняется, а не принимается молча, поэтому ключ идемпотентности защищает от дублирующихся побочных эффектов, не маскируя реальную ошибку в повторяющем клиенте.