Назначение Сервера
Сервер даёт публичный URL приёма входящих вебхуков. Настройки Сервера определяют, какие обращения принимать и какой ответ возвращать отправителю. Получателей задают Каналы и Ендпоинты, а связывают их с Сервером Маршрутизаторы.
Когда нужен отдельный Сервер
Создавайте разные Серверы, если нужны разные публичные адреса, регионы или правила приёма. Пути одного адреса не являются независимыми Серверами. Для самостоятельной отправки через Outbound API входящий Сервер не нужен.
Создание
В кабинете откройте Inbound → Servers и форму создания (
/inbound/servers/new).Введите понятное имя и выберите доступный регион. Регион не подставляется по умолчанию.
Разрешите методы отправителя; для первого примера оставьте
POST.Проверьте фильтры IP и Content-Type, настройки ответа и нажмите Create server.
Откройте карточку и скопируйте адрес. Для доставки затем создайте Канал с Ендпоинтом и Маршрутизатор.
Имя и заметки помогают различать назначения; не записывайте в них секреты.
Создание Сервера: регион выбирается явно, настройки приёма и ответа находятся в одной форме. Демонстрационный кабинет, английский интерфейс. Открыть полный размер.
Ограничения по IP
Режим any не применяет список, allow требует совпадения, deny запрещает совпадения. Поддерживаются адреса и сети по правилам поля. Фильтр не заменяет проверку подписи провайдера в вашем обработчике.
Для первого теста используйте понятную конфигурацию без ограничения по IP, затем настройте список под реального отправителя. Фильтры по IP не заменяют проверку подписи отправителя в вашем приложении.
Входящий Content-Type
Фильтры any, allow и deny относятся к типу входящего запроса, а не к типу ответа Сервера. Сравнение не учитывает регистр и параметры вроде charset. Если выбран allow, отсутствующий или некорректный Content-Type не проходит фильтр.
Ответ отправителю
Укажите код, Content-Type и при необходимости статическое тело ответа. По умолчанию код — 202. Для 204 и 205 непустое тело запрещено; HEAD не получает тело. Ответ приёма не зависит от будущего результата доставки каждому Ендпоинту.
Add CORS headers включает CORS для ответов найденного Сервера; credentials не включаются. При включённом CORS OPTIONS обрабатывается как предварительный запрос и не создаёт обычную запись вебхука. CORS не является аутентификацией отправителя.
Адрес
Адрес генерирует сервис; адрес и регион после создания не меняются. Используйте URL из карточки Сервера, а не пример из документации. После удаления адрес не выдаётся новому Серверу.
Регион
Выберите регион при создании. Для перехода в другой регион нужен новый Сервер и переключение URL у отправителя. Подробнее — Регионы.
Приём запросов
Запрос проходит проверки метода, IP, Content-Type и квоты. Непрошедшее обращение не доставляется получателям. Успешный настроенный ответ отправителю не означает успешной обработки вашим приложением.
Пути и query
Отправитель может добавить путь и query к адресу Сервера. При доставке они присоединяются к базовому URL Ендпоинта; учитывайте итоговый путь обработчика. Например, база https://receiver.example/adal и входящий /demo?source=docs дают /adal/demo?source=docs у получателя. Не добавляйте query в сам базовый URL Ендпоинта.
Размер и отклонение
У Inbound и Outbound разные технические ограничения. При отказе проверьте HTTP-код и причину в журнале: 405 — метод, 403 — IP, 415 — Content-Type, 429 — квота. Не все технические ошибки до приёма создают запись запроса.
Расход
У принятого запроса учитывается не только тело, но и путь/query и заголовки. Квота общая с Outbound. Пакеты трафика не задают отдельный срок хранения. См. Трафик и баланс.
Журнал Сервера
Откройте Inbound → Requests, выберите Сервер и регион. Карточка содержит метаданные, доступные HTTP-данные и историю получателей. См. Запросы.
Получатели
Создайте Канал типа Direct или CLI, сохраните его Ендпоинты и подключите через включённый Маршрутизатор. Создание Сервера или Канала по отдельности доставку не настраивает. Один Сервер может быть связан с несколькими Каналами.
Очереди доставки
У Ендпоинтов независимая работа и повторы. Не рассчитывайте на строгий общий порядок или немедленное исполнение. Подключение нового Ендпоинта не означает отправку всей прежней истории.
Replay
В текущем кабинете нет отдельной команды replay. Для нового теста отправьте новое демонстрационное событие. Изменение настроек не перезапускает завершённые запросы. Правила повторов отличаются от ручной отправки нового события.
Безопасная интеграция
Проверяйте подпись отправителя в обработчике и защищайтесь от повторных эффектов. Не публикуйте реальный адрес Сервера с секретным путём, тела, токены или подписи в примерах и скриншотах. Фильтры приёма не заменяют бизнес-проверки.
Удаление
Сначала удалите Сервер из всех Маршрутизаторов: даже выключенный Маршрутизатор сохраняет связь. Иначе удаление отвечает server_in_use. Удаление самого Сервера требует подтверждения и прекращает новый приём; это не немедленное удаление всех прежних HTTP-данных. См. Хранение.
Если запрос не приходит
Проверьте полный URL, регион, разрешённый метод, фильтры и остаток. Если приём есть, но доставки нет, проверьте отдельно Маршрутизатор, тип Канала, включённый Ендпоинт и доступность получателя от исполнителя.