Кратковременный сбой мобильной сети при нажатии кнопки ставит инженера перед дилеммой: повтор запроса может создать дубликаты в базе данных, а отказ от ретрая приведет к потере действия пользователя. В кейсе SwairIt описана надежная трехуровневая схема защиты в браузере и на сервере.
Первый шаг — отказ от ручек-переключателей: эндпоинты вида /toggle при повторе инвертируют состояние, поэтому API должен принимать конкретный статус (например, want_done: true). В браузере Service Worker перехватывает сетевые вызовы: при обрыве соединения или кодах 502–504 он сохраняет запрос в локальную базу IndexedDB и возвращает статус 202 Accepted. Для библиотеки htmx заголовок HX-Reswap: none предотвращает мерцание и поломку DOM-дерева.
На сервере FastAPI и PostgreSQL входящий Idempotency-Key фиксируется в таблице до старта бизнес-логики. Повторный вызов с тем же ключом отдает уже готовый ответ, а параллельный — статус 409 Conflict. Поскольку в браузерах Safari отсутствует Background Sync API, выгрузка локальной очереди дублируется по системному событию online, сохраняя пользовательские клики после восстановления связи.
![Node.JS [ru]](/api/digests/it_development/daily/20260920/assets/sources/we-use-js.jpg?v=a686569bdef27a4042c3088aa0dc6fa248fe1114ebac27669ecc3123402803be)