## Назначение Сервера {#what-is-server}

Сервер даёт публичный URL приёма входящих вебхуков. Настройки Сервера определяют, какие обращения принимать и какой ответ возвращать отправителю. Получателей задают Каналы и Ендпоинты, а связывают их с Сервером Маршрутизаторы.

## Когда нужен отдельный Сервер {#when-to-use-servers}

Создавайте разные Серверы, если нужны разные публичные адреса, регионы или правила приёма. Пути одного адреса не являются независимыми Серверами. Для самостоятельной отправки через Outbound API входящий Сервер не нужен.

## Создание {#create-a-server}

1. В кабинете откройте **Inbound → Servers** и форму создания (`/inbound/servers/new`).
2. Введите понятное имя и выберите доступный регион. Регион не подставляется по умолчанию.
3. Разрешите методы отправителя; для первого примера оставьте `POST`.
4. Проверьте фильтры IP и Content-Type, настройки ответа и нажмите **Create server**.
5. Откройте карточку и скопируйте адрес. Для доставки затем создайте Канал с Ендпоинтом и [Маршрутизатор](/ru/docs/inbound/routers).

Имя и заметки помогают различать назначения; не записывайте в них секреты.

![Форма создания Сервера: регион, методы, фильтры и ответ отправителю](/images/docs/inbound/server-create-en.jpg)

*Создание Сервера: регион выбирается явно, настройки приёма и ответа находятся в одной форме. Демонстрационный кабинет, английский интерфейс.* [Открыть полный размер](/images/docs/inbound/server-create-en.jpg).

## Ограничения по IP {#ip-access-restrictions}

Режим `any` не применяет список, `allow` требует совпадения, `deny` запрещает совпадения. Поддерживаются адреса и сети по правилам поля. Фильтр не заменяет проверку подписи провайдера в вашем обработчике.

Для первого теста используйте понятную конфигурацию без ограничения по IP, затем настройте список под реального отправителя. Фильтры по IP не заменяют проверку подписи отправителя в вашем приложении.

## Входящий Content-Type {#content-type-restrictions}

Фильтры `any`, `allow` и `deny` относятся к типу входящего запроса, а не к типу ответа Сервера. Сравнение не учитывает регистр и параметры вроде charset. Если выбран `allow`, отсутствующий или некорректный Content-Type не проходит фильтр.

## Ответ отправителю {#response-to-the-sender}

Укажите код, Content-Type и при необходимости статическое тело ответа. По умолчанию код — `202`. Для `204` и `205` непустое тело запрещено; `HEAD` не получает тело. Ответ приёма не зависит от будущего результата доставки каждому Ендпоинту.

**Add CORS headers** включает CORS для ответов найденного Сервера; credentials не включаются. При включённом CORS `OPTIONS` обрабатывается как предварительный запрос и не создаёт обычную запись вебхука. CORS не является аутентификацией отправителя.

## Адрес {#server-url}

Адрес генерирует сервис; адрес и регион после создания не меняются. Используйте URL из карточки Сервера, а не пример из документации. После удаления адрес не выдаётся новому Серверу.

## Регион {#regions}

Выберите регион при создании. Для перехода в другой регион нужен новый Сервер и переключение URL у отправителя. Подробнее — [Регионы](/ru/docs/common/regions).

## Приём запросов {#incoming-requests}

Запрос проходит проверки метода, IP, Content-Type и квоты. Непрошедшее обращение не доставляется получателям. Успешный настроенный ответ отправителю не означает успешной обработки вашим приложением.

## Пути и query {#paths-and-query-parameters}

Отправитель может добавить путь и query к адресу Сервера. При доставке они присоединяются к базовому URL Ендпоинта; учитывайте итоговый путь обработчика. Например, база `https://receiver.example/adal` и входящий `/demo?source=docs` дают `/adal/demo?source=docs` у получателя. Не добавляйте query в сам базовый URL Ендпоинта.

## Размер и отклонение {#request-limits}

У Inbound и Outbound разные технические ограничения. При отказе проверьте HTTP-код и причину в журнале: `405` — метод, `403` — IP, `415` — Content-Type, `429` — квота. Не все технические ошибки до приёма создают запись запроса.

## Расход {#credits}

У принятого запроса учитывается не только тело, но и путь/query и заголовки. Квота общая с Outbound. Пакеты трафика не задают отдельный срок хранения. См. [Трафик и баланс](/ru/docs/common/traffic).

## Журнал Сервера {#requests-in-a-server}

Откройте **Inbound → Requests**, выберите Сервер и регион. Карточка содержит метаданные, доступные HTTP-данные и историю получателей. См. [Запросы](/ru/docs/inbound/requests).

## Получатели {#destinations}

Создайте Канал типа Direct или CLI, сохраните его Ендпоинты и подключите через включённый Маршрутизатор. Создание Сервера или Канала по отдельности доставку не настраивает. Один Сервер может быть связан с несколькими Каналами.

## Очереди доставки {#delivery-behavior}

У Ендпоинтов независимая работа и повторы. Не рассчитывайте на строгий общий порядок или немедленное исполнение. Подключение нового Ендпоинта не означает отправку всей прежней истории.

## Replay {#replay}

В текущем кабинете нет отдельной команды replay. Для нового теста отправьте новое демонстрационное событие. Изменение настроек не перезапускает завершённые запросы. [Правила повторов](/ru/docs/common/retries) отличаются от ручной отправки нового события.

## Безопасная интеграция {#security-notes}

Проверяйте подпись отправителя в обработчике и защищайтесь от повторных эффектов. Не публикуйте реальный адрес Сервера с секретным путём, тела, токены или подписи в примерах и скриншотах. Фильтры приёма не заменяют бизнес-проверки.

## Удаление {#delete-a-server}

Сначала удалите Сервер из всех Маршрутизаторов: даже выключенный Маршрутизатор сохраняет связь. Иначе удаление отвечает `server_in_use`. Удаление самого Сервера требует подтверждения и прекращает новый приём; это не немедленное удаление всех прежних HTTP-данных. См. [Хранение](/ru/docs/common/storage).

## Если запрос не приходит {#troubleshooting}

Проверьте полный URL, регион, разрешённый метод, фильтры и остаток. Если приём есть, но доставки нет, проверьте отдельно Маршрутизатор, тип Канала, включённый Ендпоинт и доступность получателя от исполнителя.

## Дальше {#related-pages}

[Быстрый старт](/ru/docs/inbound/quickstart), [Каналы и Ендпоинты](/ru/docs/inbound/destinations), [Direct](/ru/docs/inbound/direct), [CLI](/ru/docs/inbound/adal-cli).