При подключении нового сервиса часто хочется сначала увидеть, что именно он отправляет. Какие поля приходят в теле вебхука? Где находится идентификатор события? Какие заголовки добавляет отправитель? Пример из документации помогает начать, а реальный запрос — разобраться в конкретной интеграции.
Мы запустили Adal Cloud Go, или сокращённо Adal Go, для такой быстрой проверки. Откройте go.adal.cloud, получите временный HTTPS-адрес и отправьте на него вебхук. Входящий запрос появится в браузере, где можно изучить его содержимое. Всё это бесплатно и без регистрации.
От адреса до первого запроса
Для начала работы достаточно нескольких действий:
Откройте Adal Go и нажмите Get URL.
Скопируйте выданный адрес и укажите его в настройках вебхуков нужного сервиса.
Отправьте тестовое событие или выполните действие, которое вызывает вебхук.
Выберите появившийся запрос в списке и изучите его.
Не нужно устанавливать программу, запускать локальный обработчик или создавать аккаунт. Полученный URL можно использовать как есть либо добавить к нему нужный путь и query-параметры.
Adal Go показывает HTTP-метод, время приёма, путь, query-параметры, заголовки и тело запроса. Поэтому можно проверить не только состав данных, но и то, на какой путь отправитель направляет событие и что передаёт в URL.
Сначала увидеть данные, затем писать обработчик
Допустим, вы подключаете уведомления о новых заказах. В документации отправителя есть пример JSON, но перед разработкой нужно понять, как выглядит событие именно для вашего тестового заказа: какие поля заполнены, что приходит вложенным объектом и где находится тип события.
Укажите адрес Adal Go в тестовых настройках отправителя, создайте заказ и откройте полученный запрос. Теперь перед вами конкретные данные, на основе которых проще написать обработчик и проверить свои предположения о формате.
Такой же подход полезен, когда нужно проверить настройки уже существующей интеграции. Например, убедиться, что сервис отправляет нужный тип события, передаёт ожидаемый заголовок или использует правильный путь. На этапе просмотра не требуется подключать к запросу приложение-получатель.
Adal Go удобен и для знакомства с вебхуками: можно вызвать событие и сразу увидеть, каким HTTP-запросом оно представлено. Между действием в сервисе и просмотром результата остаётся минимум настройки.
Временный просмотр с понятными границами
Adal Go предназначен для работы в открытой подключённой вкладке. Он не сохраняет вебхуки для последующего просмотра и не закрепляет за вами постоянный адрес. Последние 40 событий доступны в памяти вкладки; серверной истории запросов нет.
Обновление активной вкладки создаёт новый URL и очищает список. После этого адрес в настройках отправителя нужно заменить. При коротком обрыве соединения та же вкладка может восстановить подключение к прежнему адресу в течение 30 секунд, но пропущенные во время отключения запросы не воспроизводятся.
На один временный адрес принимается до 60 запросов в минуту, размер тела одного запроса — до 256 KiB. Эти ограничения подходят для проверки отдельных событий и небольших тестовых серий.
Adal Go также не пересылает вебхуки другим HTTP-получателям и не работает с Adal CLI. Через него можно посмотреть запрос, но нельзя доставить этот запрос локальному приложению. Для постоянного приёма, хранения и дальнейшей доставки предназначена полная версия Adal Cloud.
Когда нужен следующий шаг
После первого знакомства с форматом события задачи обычно становятся шире. Нужен постоянный URL, чтобы не менять настройки отправителя. Нужно вернуться к запросу позже, переслать его обработчику или получить вебхук в приложении на своём компьютере.
Для этого зарегистрируйтесь в Adal Cloud. В полной версии доступны постоянные URL Серверов Adal Cloud, сохранение запросов для последующего просмотра, доставка HTTP-получателям и работа с Adal CLI для локальных и закрытых окружений. Настройка описана в документации.
Регистрация бесплатна. Начать работу в полной версии тоже можно бесплатно: после подтверждения почты доступен пакет 10 MiB, который обновляется каждые 30 дней без накопления. Для большего объёма можно приобрести дополнительный трафик; правила приведены в документации трафика и оплаты.
Если сейчас нужно просто узнать, что отправляет сервис, начните с Adal Go: получите адрес, вызовите событие и откройте вебхук в браузере.