Свои домены для API, приложений и вебхуков
TLS, свой hostname и DNS под вашим контролем для маршрутов шлюза и контейнерных приложений: публичные API, веб-приложения, стабильные эндпоинты вебхуков и коллбеки партнёров — без «чужого» адреса провайдера в интеграциях.
Обновлено: 2026-06-28
Кратко
Суть ответа
Свои домены для API, приложений и вебхуков. Домен подключается на уровне шлюза: маршрутизация функций и терминация TLS остаются согласованными в одном месте.
Когда подходит
- Публичные API для клиентов
- Эндпоинты вебхуков, которые партнёры вносят в allowlist
На что обратить внимание
- Зашитые в код URL вендора мешают white-label и мультитенантности: каждая клиентская интеграция наследует hostname, который потом не переименовать.
- Неверно настроенный TLS или устаревший CNAME дают плавающие сбои с cookie авторизации, которые мучительно отлаживать со стороны приложения.
Нагрузка и где ломается
Почему hostname важен
Свой домен снижает риск фишинга, оставляет дефолты SDK чистыми и делает API частью вашего продукта, а не арендованным эндпоинтом.
Часть enterprise-заказчиков ещё до подписания договора ждёт, что контроль над сертификатами и DNS для их тенанта будет задокументирован.
Компромиссы
Что ломается без плана
Зашитые в код URL вендора мешают white-label и мультитенантности: каждая клиентская интеграция наследует hostname, который потом не переименовать.
Неверно настроенный TLS или устаревший CNAME дают плавающие сбои с cookie авторизации, которые мучительно отлаживать со стороны приложения.
Как помогает Inquir
Как свой домен подключается к шлюзу
Домен подключается на уровне шлюза: маршрутизация функций и терминация TLS остаются согласованными в одном месте.
Многие провайдеры вебхуков — Stripe, GitHub, Shopify, Slack — просят внести конкретный hostname в allowlist в своей консоли. Стабильный api.yourproduct.com проще поддерживать и аудировать, чем меняющийся URL, сгенерированный вендором.
Сочетайте свой домен с API-ключами и другими режимами авторизации на маршруте — как того требуют ваши интеграции.
Свой домен можно привязать и к контейнерному приложению: укажите hostname, подтвердите владение TXT-записью, и платформа начнёт маршрутизировать его с автоматическим сертификатом. WebSocket и server-sent events проходят напрямую.
Что вы получаете
Настройка домена для API и вебхуков
DNS
Спланируйте владение зоной и TTL до окна переключения, чтобы сам переход прошёл скучно.
Сертификаты
Автоматизируйте продление везде, где это позволяют DNS и политика выпуска.
Мультитенантность
См. мультитенантную маршрутизацию, если нужен отдельный hostname на клиента при общих сертификатах.
Контейнерные приложения
Поставьте веб-приложение или API-сервис за свой hostname командой inquir apps domain или в консоли; домен следует за продакшеном при релизах и откатах.
Что дальше
Как привязать свой домен к шлюзу Inquir
Подтвердить домен
Докажите владение DNS-записями, которые ожидает платформа.
Назначить маршруты
Привяжите пути или wildcard-шаблоны к нужным функциям.
Наблюдать
После запуска в продакшене следите за ошибками рукопожатия и всплесками 4xx.
Пример кода
Сначала DNS, потом маршруты
Держите подтверждение владения DNS отдельно от прикладной маршрутизации — они ломаются по-разному, и отлаживают их разные люди.
{ "host": "api.example.com", "routes": [{ "path": "/v1/ingest", "functionId": "ingest" }] }
Когда подходит
Когда нужен свой домен
Когда это уместно
- Публичные API для клиентов
- Эндпоинты вебхуков, которые партнёры вносят в allowlist
Когда лучше выбрать другое
- Чисто внутренние инструменты, где хватает домена по умолчанию
Частые вопросы
Частые вопросы
Можно ли использовать wildcard-поддомены для клиентских API?
Зависит от развёртывания и автоматизации сертификатов: проверьте выпуск и продление wildcard в своём окружении, прежде чем обещать это в договорах.
Что ломается при ошибке в DNS или TLS?
Клиенты видят сбой рукопожатия или не тот маршрут. Срок действия сертификата и здоровье CNAME мониторьте отдельно от релизов приложения.
Как свой домен связан с URL вебхуков?
Партнёры часто вносят ваш hostname в allowlist; стабильный api.yourproduct.com проще аудировать, чем меняющийся адрес вендора по умолчанию.
Можно ли дать контейнерному приложению свой домен?
Да. Привяжите hostname к приложению, добавьте TXT-запись, которую покажет платформа, направьте DNS-запись на приложение — и сертификат выпустится автоматически.