Универсальный вебхук-коннектор
Аутентифицированные вызовы любого API, входящие триггеры с проверкой HMAC и чтение с пагинацией — коннектор, стоящий за каждым «мы интегрируемся с X».
Это коннектор, который делает «любой инструмент» честным обещанием. Исходящее: HTTP-вызовы для каждой записи с basic, OAuth (автообновление и повтор), API-ключом или bearer-аутентификацией, свои заголовки, тела JSON или XML, опциональная JavaScript-трансформация на запись и повторы с экспоненциальной задержкой. Входящее: каждый рабочий процесс получает уникальный вебхук-URL, защищённый секретным заголовком, с опциональной HMAC-проверкой подписи в стиле GitHub. И чтение: коннектор опроса с тремя стратегиями пагинации, курсорами и инкрементальными since-метками, превращающий любой API в источник данных по расписанию.
Триггеры workflow
Уникальный входящий URL на каждый процесс
POST/PUT/DELETE на URL рабочего процесса с секретным кодовым заголовком запускает поток.
Проверка HMAC-подписи
Опциональные SHA-256-подписи тела (настраиваемый заголовок, стиль GitHub или чистый hex, сравнение с постоянным временем) для источников, подписывающих свои вызовы.
Захват тестовых данных в черновике
Неопубликованные рабочие процессы захватывают образец полезной нагрузки, чтобы конструктор мог сопоставлять поля по реальным данным до запуска.
Действия workflow
Вызов любого API
HTTP для каждой записи с вашим режимом аутентификации, своими заголовками, полезной нагрузкой JSON или XML, опциональной JS-трансформацией на запись и повторами 429/5xx с экспоненциальной задержкой.
OAuth: обновление и повтор
Истёкшие токены автоматически обновляются по вашему refresh-URL, и вызов повторяется.
Как движутся данные
Двунаправленный по построению: любая система, умеющая отправлять HTTP, может запускать ваши рабочие процессы, а в любой API, к которому вы можете аутентифицироваться, можно писать или его опрашивать — с пагинацией (заголовки Link, пути next-URL или параметры страниц), курсорами и инкрементальными since-метками в формате, который ожидает ваш API.
Подключение: Учётные данные подключений хранятся по рабочим пространствам: basic-аутентификация, OAuth с URL обновления токена, API-ключ в произвольном заголовке или bearer-токен.
Практический пример: Внутренний инструмент вовсе без «интеграции»
Создайте вебхук-подключение с bearer-токеном вашего внутреннего API.
Триггер: подходящие ответы на опросы запускают рабочий процесс.
Действие: каждая запись отправляется POST-запросом на ваш внутренний эндпоинт, преобразованная небольшой JS-трансформацией.
Плановое чтение еженощно опрашивает тот же API на предмет изменений, листая страницы до конца.
Готовые шаблоны flow
Установите готовый шаблон и адаптируйте его — не нужно строить с нуля.
Настройка
1.
Создайте вебхук-подключение с режимом аутентификации вашего API.
2.
Для входящих: скопируйте уникальный URL рабочего процесса и секретный заголовок в систему-источник.
3.
Для чтения: один раз настройте пагинацию и since-параметр; поставьте на расписание.
Частые вопросы
Какие режимы аутентификации поддерживаются?
Basic-аутентификация, OAuth с автоматическим обновлением и повтором, API-ключ в заголовке с произвольным именем и bearer-токены.
Как защищены входящие вебхуки?
URL каждого рабочего процесса требует секретный кодовый заголовок, а поверх доступны опциональные подписи тела HMAC-SHA256 (настраиваемый заголовок, сравнение с постоянным временем).
Умеет ли он читать API, а не только вызывать их?
Да — коннектор опроса поддерживает пагинацию через Link-заголовки, next-URL и page/pageSize, плюс курсоры и инкрементальные since-метки, превращая любой API в источник данных по расписанию.