Ключ идемпотентности
Ключ идемпотентности — уникальное значение в запросе, благодаря которому его повтор возвращает исходный результат, а не выполняет действие дважды.
Подробно
Отправляйте его в каждом POST, который тратит деньги. Повтор с тем же ключом в течение 24 часов вернёт исходный ответ, а не купит второй номер, — ровно это и нужно, когда запрос отвалился по таймауту и непонятно, прошёл он или нет. Ключ покрывает операцию целиком, а не отдельную попытку, и повтор помечается заголовком Idempotent-Replay, чтобы в логах было видно, что произошло.
Также известно как
- idempotent request
- safe retry