Доставка и повторные попытки

Как Dcision доставляет вебхуки, API-запросы, workflows и передачу агентам — минимум один раз, шесть попыток примерно за семь часов, Retry-After, тайм-ауты, статусы, повторная отправка и хранение.

Вебхуки, API-запросы, workflows и агенты в режиме async — это доставки: сначала решение отвечает, а затем Dcision отправляет их в фоне. Ответ сообщает, что поставлено в очередь:

{ "key": "notify_sales", "type": "webhook", "status": "queued", "delivery_id": "dlv_8kJx2mQp4LzN7vR1tY6w" }

Минимум один раз

Доставка отправляется минимум один раз. Получатель, у которого истёк тайм-аут или потерялся ответ, получит ту же доставку снова, поэтому делайте получателей идемпотентными с помощью ID доставки — одинакового во всех попытках и при повторных отправках:

ТипГде находится ID доставки
ВсеЗаголовок Dcision-Delivery.
webhookid события.
http, workflow, agentЗаголовок Idempotency-Key (если вы не задали свой); dcision.delivery_id в workflows, decision.delivery_id для агентов.

Порядок доставок не гарантируется: две доставки одного решения — или двух решений — могут прийти в любом порядке.

Попытки

ПопыткаКогда
1сразу
2через 30 секунд после первой попытки
3через 2 минуты после второй
4через 10 минут после третьей
5через 1 час после четвёртой
6через 6 часов после пятой

Это 6 попыток примерно за 7 часов. Заголовок Dcision-Attempt указывает номер попытки, и каждая попытка подписывается заново со свежей меткой времени.

Получатель…Результат
отвечает 2xxДоставлено.
отвечает 408, 425, 429 или 5xx, не успевает ответить или недоступенПовтор по расписанию выше. При 429 или 503 заголовок Retry-After — в секундах или в виде даты — задаёт ожидание вместо расписания, от 1 секунды до 6 часов.
отвечает любым другим 4xxСразу ошибка: исправьте назначение, затем отправьте повторно.
отвечает редиректом (3xx)Сразу ошибка: редиректы никогда не выполняются — используйте конечный URL.
разрешается в непубличный адрес, или URL некорректен после подстановки переменныхСразу ошибка — см. Безопасность и лимиты.

На каждую попытку отводится 10 секунд. Dcision читает до 64 КБ ответа и сохраняет его код статуса, задержку и первые 1 024 символа, которые приложение показывает рядом с доставкой.

Статусы

СтатусВ приложенииЗначение
PENDINGотправка · повторОжидает следующей попытки.
SENDINGотправкаПопытка выполняется. Попытка, прерванная перезапуском, подхватывается снова через 60 секунд.
SUCCEEDEDдоставленоОтвет 2xx.
FAILEDошибкаОкончательная ошибка или 6 попыток без успеха.

Где за ними следить:

  • Результат в Playground и подробности выполнения в разделе Выполнения показывают каждое назначение с его текущим статусом, попытками, HTTP-статусом и задержкой, следующей попыткой и ошибкой — и тестовый режим для доставок с livemode: false.
  • Обзор решения считает доставленные, неудачные и ожидающие доставки по каждому назначению.

Доставки видят все в рабочем пространстве; приложение никогда не показывает их тело — только замаскированный предпросмотр запроса.

Повторная отправка неудачной доставки

Отправить повторно у неудачной доставки (Участники, Администраторы и Владелец) снова ставит её в очередь с 6 новыми попытками и тем же ID доставки, чтобы получатель, который всё же её обработал, мог дедуплицировать.

Сформированный запрос — с его секретами — хранится в зашифрованном виде, пока он может понадобиться доставке: он удаляется, когда доставка успешна, и сохраняется для неудачных, чтобы их можно было отправить повторно. Повторная отправка отправляет тот же самый запрос: изменение назначения или секрета применяется к новым запускам решения, а не к повторным отправкам.

Темп и лимиты

  • Рабочее пространство отправляет до 600 доставок в минуту. Доставки сверх этого ждут следующей минуты, не расходуя попытку.
  • Ответ не ждёт доставок: они ставятся в очередь вместе с запуском и стартуют сразу, в фоне.
  • Если доставку вообще не удаётся поставить в очередь (очередь недоступна), её запись содержит "status": "skipped", "reason": "unavailable", а решение всё равно отвечает.

Хранение

Завершённые доставки — успешные или неудачные — удаляются через 30 дней после создания, независимо от срока хранения журнала выполнений рабочего пространства. Удаление решения не отменяет уже поставленные в очередь доставки: они завершают свои попытки и истекают вместе с остальными. Удаление рабочего пространства удаляет их все.

Идемпотентность и повторы

  • Идемпотентный повтор возвращает сохранённый ответ с теми же ID доставок, и ничего не доставляется повторно.
  • Запрос с тем же Idempotency-Key, который ещё выполняется, получает 409 с Retry-After: 1 — он никогда не выполняется и не доставляется дважды.
  • Fallback при ошибке движка не сохраняется для идемпотентности: повтор запускает решение снова и ставит в очередь новые доставки, с новыми ID.

На этой странице