Миссия 2 · Надежный webhook
Примите реальные события безопасно и ровно один раз.
Создайте границу webhook, которая отвечает на проверку monday.com, проверяет ожидаемое событие, сохраняет намерение до возникновения побочных эффектов и предотвращает дублирование собраний и дублирование write-back.
Последовательность сборки
- Верните запрос на проверку monday.com точно и быстро.
- Проверьте форму события, доску, элемент, столбец, действие и режим аутентификации, доступный для интеграции.
- Получите и сохраните ключ idempotency перед созданием собрания или мутацией CRM.
- Своевременно подтверждайте, переводите длительную работу в асинхронный режим и сохраняйте надежный журнал событий.
- Проверьте повторную доставку, отсутствующий идентификатор элемента, неправильный столбец, неподдерживаемый статус, задержку нисходящего API и повторную попытку поставщика.
Требуемое доказательство
- Результат проверки запроса и контракт очищенного запроса.
- Дублированная доставка приводит к одному побочному бизнес-эффекту.
- Одна трассировка сбоя с полезным для оператора сообщением об ошибке и идентификатором корреляции.
Справочные файлы и источники
Официальная документация поставщика
Оценочные ворота
Проходить
Пройдено: тесты воспроизведения и параллелизма демонстрируют одно устойчивое намерение и один внешний побочный эффект.
Исправлять
Пересмотр: обычные запросы работают, но устойчивое сохранение, защита от повтора или свидетельства сбоев являются неполными.
Тяжелый провал
Жесткий сбой: конечная точка доверяет произвольным полезным нагрузкам, регистрирует секреты или создает дублирующие собрания или записи.
Представление, проверенное человеком