Создайте аккаунт
Создайте аккаунт Adal перед настройкой приёма вебхуков. Сейчас Adal поддерживает регистрацию по электронной почте.
Откройте страницу регистрации Adal.
Укажите адрес электронной почты и завершите регистрацию.
Откройте письмо от Adal и перейдите по ссылке для подтверждения.
Войдите в панель управления.
Ожидаемый результат: аккаунт активирован, и вам доступна панель управления.
Создайте Server
Server предоставляет стабильный публичный URL для приёма вебхуков.
Откройте раздел Servers.
Нажмите Create server.
Выберите регион обработки и укажите название.
Для этого руководства оставьте остальные настройки по умолчанию, затем сохраните Server.
После создания скопируйте Public Ingest URL и сохраните CLI token.
Важно: CLI token показывается только один раз. Считайте его секретом: храните безопасно, не добавляйте в систему контроля версий и не включайте в логи или обращения в поддержку.
Ожидаемый результат: Server создан, у вас есть его Public Ingest URL и CLI token.
Создайте Destination
Destination определяет, куда доставляется принятый Request. Один Request может независимо доставляться в несколько Destinations.
Откройте раздел Destinations.
Нажмите Add destination.
Выберите тот же регион и созданный ранее Server.
Укажите название и URL сервиса, который должен получить вебхук.
Сохраните Destination.
Для локальной проверки через CLI можно использовать URL наподобие http://127.0.0.1:3000/webhooks. Локальное приложение должно быть запущено и принимать запросы по указанному адресу. Для прямой доставки используйте URL, доступный из интернета.
Ожидаемый результат: Destination связан с вашим Server и готов принимать Deliveries.
Запустите Adal CLI
Adal CLI поддерживает безопасное исходящее соединение и пересылает входящие Requests в локальный или закрытый сервис. Скачайте готовую сборку или соберите CLI из исходного кода.
Запустите CLI с токеном, который вы сохранили при создании Server:
adal-cli --token <your-cli-token>
Полезные параметры:
adal-cli --version
adal-cli --verbose <level>
Уровни подробности:
| Уровень | Вывод |
|---|---|
0 |
Только ошибки; используется по умолчанию. |
1 |
Основная информация о соединении и доставке. |
2 |
Подробные рабочие логи. |
3 |
Отладочные логи. |
Пример:
adal-cli --token <your-cli-token> --verbose 1
Ожидаемый результат: CLI успешно подключён и ожидает входящие Deliveries.
Отправьте тестовый вебхук
Замените адрес-заглушку ниже на Public Ingest URL из панели управления и отправьте тестовый запрос:
SERVER_URL='https://your-server-id.region.adal.cloud'
curl --request POST "$SERVER_URL" \
--header 'Content-Type: application/json' \
--header 'X-Test-Source: quickstart' \
--data '{"message":"Hello from Adal"}'
Adal принимает вебхук как Request, создаёт Delivery для настроенного Destination и пересылает его через подключённый CLI или напрямую по HTTP — в зависимости от конфигурации. Исходные HTTP-метод, путь, строка запроса, заголовки и тело сохраняются.
Ожидаемый результат: Request появился в Adal, а попытка доставки достигла настроенного Destination. Успешный Delivery означает, что Adal получил ожидаемый HTTP-ответ от Destination; это не подтверждает выполнение бизнес-операции в вашей системе.
Изучите Request
Откройте раздел Requests, выберите Request из предыдущего шага и откройте подробности.
Вы можете проверить:
HTTP-метод, путь и строку запроса;
заголовки и тело запроса;
время получения и статус Request;
Delivery для каждого Destination и историю попыток.
Для поддерживаемых форматов тело можно просмотреть в браузере или скачать в исходном виде, если эта возможность доступна.
Важно: повторные попытки и ручной replay могут привести к повторной доставке одного события. Проверяйте подпись отправителя, валидируйте входные данные, делайте обработчики вебхуков идемпотентными и устраняйте дубликаты по стабильному идентификатору события провайдера, если он доступен.
Ожидаемый результат: вы видите, что получил Adal, и можете проследить результат каждой попытки Delivery.
Что дальше
Базовый сценарий завершён: Server принял вебхук, Adal сохранил его как Request, а Destination получил Delivery.
Продолжите знакомство с документацией: