• 228 направлений
  • Без KYC — всегда
  • Bitcoin, Monero, USDT и ещё 4 валюты

API и интеграция

Экспоненциальная задержка повторных запросов

Экспоненциальная задержка — это стратегия увеличения паузы после каждой неудачной попытки — 1, 2, 4, 8 секунд и далее, — применяемая к ответам 429 и 5xx, чтобы повторы не усиливали перегрузку.

Если запрос не прошёл по временной причине — из-за тайм-аута, ответа 503 или 429, — немедленные многократные повторы только усиливают перегрузку и для вас, и для всех, кто пользуется тем же сервисом. Экспоненциальная задержка разносит попытки во времени: выждать базовую задержку, после каждой неудачи удваивать её вплоть до заданного потолка и остановиться после фиксированного числа попыток или по истечении крайнего срока.

На практике важны два уточнения. Джиттер — случайная составляющая каждой задержки — не даёт множеству клиентов, получивших ошибку в один и тот же момент, повторять запросы синхронно и снова обрушивать сервис. А указания самого сервера главнее: если ответ 429 содержит Retry-After, это значение имеет приоритет над рассчитанной задержкой. Кроме того, задержка имеет смысл только вместе с идемпотентностью, поскольку повторная отправка ни в коем случае не должна превращаться в дубликат.

ОтветПовторять?
429Да, по истечении Retry-After
5xx, тайм-аут, сетевая ошибкаДа, с задержкой и тем же ключом идемпотентности
Большинство других 4xxНет; исправьте запрос

Пример

Условный клиент начинает с одной секунды, каждый раз удваивает задержку и добавляет полный джиттер, делая всего пять попыток: между ними он ждёт случайное время — до 1, 2, 4 и затем 8 секунд. Короткий сбой обходится в несколько секунд и без дубликатов; длительный завершается не бесконечным циклом, а отложенным в очередь сообщением и оповещением.

Типичные ошибки

  • Использовать задержку без джиттера, из-за чего все клиенты повторяют запросы в одни и те же моменты.
  • Повторять запросы, не прошедшие валидацию: они каждый раз будут завершаться одинаково.
  • Генерировать новый ключ идемпотентности для каждой попытки.
  • Накладывать повторы на нескольких уровнях — в библиотеке, приложении и очереди, — из-за чего число попыток перемножается.

В SMSMeteor: политика повторов, рекомендованная на странице SDK, такова: 429 повторять через указанное в Retry-After число секунд, а 5xx — с экспоненциальной задержкой, начиная с одной секунды, всего пять попыток. При повторе всегда используйте тот же ключ идемпотентности и никогда не создавайте новый для того же логического сообщения; ошибки 4xx, кроме 429, не повторяйте — вместо этого исправьте запрос. Доставка вебхуков на ваш эндпоинт следует тому же принципу в обратном направлении: шесть попыток в течение 24 часов (сразу, затем +1 мин, +5 мин, +30 мин, +2 ч и +12 ч), после чего событие помечается как недоставленное, и его можно повторно отправить из панели в течение 30 дней. См. документацию по вебхукам.

Подробнее

Посмотрите, как это работает на практике.Для регистрации достаточно адреса электронной почты. Таблица тарифов открыта, оплата принимается в криптовалюте, тестовый ключ бесплатный.
Начать отправку