Доставка и повторные попытки
Как Dcision доставляет вебхуки, API-запросы, workflows и передачу агентам — минимум один раз, шесть попыток примерно за семь часов, Retry-After, тайм-ауты, статусы, повторная отправка и хранение.
Вебхуки, API-запросы, workflows и агенты в режиме async — это доставки: сначала решение отвечает, а затем Dcision отправляет их в фоне. Ответ сообщает, что поставлено в очередь:
{ "key": "notify_sales", "type": "webhook", "status": "queued", "delivery_id": "dlv_8kJx2mQp4LzN7vR1tY6w" }Минимум один раз
Доставка отправляется минимум один раз. Получатель, у которого истёк тайм-аут или потерялся ответ, получит ту же доставку снова, поэтому делайте получателей идемпотентными с помощью ID доставки — одинакового во всех попытках и при повторных отправках:
| Тип | Где находится ID доставки |
|---|---|
| Все | Заголовок Dcision-Delivery. |
webhook | id события. |
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.
Секреты рабочего пространства
Держите токены и секретные URL вне решений — секреты рабочего пространства через {{secrets.NAME}}, кто может ими управлять, как они хранятся и маскируются и когда применяются изменения.
Тестирование назначений
Предпросмотр назначений в Playground с замаскированными секретами, реальный запуск с livemode false, тестовые API-ключи и отслеживание доставок, попыток и ответов получателей.