Проект и домены
Имя проекта, брендированные поддомены и опасная зона удаления.
Настройки проекта
Вкладка «Настройки»: слева «Главная», «Поддомены», «Свои домены», «Ключи API» и блок командного доступа.
- Откройте «Настройки».
- На «Главной» измените название и описание проекта.
- Сохраните изменения в интерфейсе заголовка/формы.
Настройки проекта: имя, описание, удаление.
Поддомены
Поддомен даёт адрес вида https://имя.<домен-сервиса>/…. Поддомены принадлежат аккаунту и могут использоваться в разных проектах.
- «Настройки» → «Поддомены» → «+ Поддомен».
- Задайте имя → «Создать».
- В конструкторе ссылки выберите этот поддомен.
- Бейджи: «здесь» — используется ссылками текущего проекта; «в других местах» — в других проектах; «удалён · можно вернуть» — мягкое удаление.
- После удаления поддомена ссылки на нём перестают работать; в карточке статус «Поддомен удалён».
- «Восстановить» возвращает поддомен; ссылки снова работают, кроме вручную выключенных.
Список поддоменов и создание.
ВНИМАНИЕ: «Удалить поддомен» сразу ломает публичные адреса на этом имени, пока не восстановите. Перед удалением проверьте, какие ссылки на него завязаны.
Свои домены
Собственное полное доменное имя (например go.company.ru) вместо поддомена на зоне сервиса. После подтверждения владения через TXT-запись и настройки шаблонной CNAME-записи ссылки открываются на вашем домене.
- «Настройки» → «Свои домены» → «+ Домен» → укажите полное доменное имя без https://.
- В DNS добавьте TXT-запись владения (шаг 1 инструкции).
- Добавьте CNAME на шаблон `*.ваша-зона` → сервер переадресации сервиса (шаг 2).
- Нажмите «Проверить DNS». Когда статус «Активен», выберите домен в конструкторе ссылки.
Раздел «Свои домены»: список, статусы, «+ Домен».
Шаг 1 — подтверждение владения (TXT). Нужна одна TXT-запись. Host обычно `_urlshortener.{ваш-домен}` (у части регистраторов в поле Name указывают только `_urlshortener`, без зоны). Value: `urlshortener-verify=<токен>` из инструкции. TTL: 300–3600.
| Поле | Значение (пример для go.company.ru) |
|---|---|
| Type | TXT |
| Host / Name | _urlshortener.go.company.ru |
| Value | urlshortener-verify=a1b2c3d4-… |
| TTL | 300 (рекомендация) |
DNS-панель: добавление TXT `_urlshortener…` с токеном из инструкции.
Шаг 2 — маршрутизация (CNAME). CNAME на корневой домен (`@`) у большинства регистраторов нельзя. Нужен шаблон: Host `*.company.ru` → Value `edge.kkoroch.ru` (точный адрес — в инструкции). Шаблон покрывает и go.company.ru, и другие поддомены зоны. Если регистрируете сам корневой домен (company.ru), дополнительно может понадобиться A/ALIAS на `@` — см. подсказку в интерфейсе.
| Тип домена | Type | Host | Value |
|---|---|---|---|
| Поддомен go.company.ru | CNAME | *.company.ru | edge.kkoroch.ru |
| Корневой company.ru | CNAME | *.company.ru | edge.kkoroch.ru |
| Корневой без www (@), опционально | A / ALIAS | @ | IP / alias edge |
DNS-панель: шаблонная CNAME `*.зона` на сервер переадресации.
- Поддомен сервиса и свой домен взаимоисключающие для одной ссылки.
- Статусы: «Ожидает TXT» → «Нужен CNAME» → «Активен». Только активный можно выбрать в конструкторе.
- Удаление домена деактивирует ссылки на нём (статус «Домен удалён»).
- Лимит своих доменов задаётся тарифом (на Free+ часто 0).
- Между проверками DNS — пауза ~15 с.
Домен в статусе «Активен» после успешной проверки DNS.
ВНИМАНИЕ: Записи DNS часто вступают в силу не сразу (минуты, иногда до нескольких часов из‑за TTL и кеша резолверов). Если после «Проверить DNS» статус ещё не «Активен» — подождите и повторите проверку; повторно сохранять записи обычно не нужно.
ВНИМАНИЕ: Нельзя зарегистрировать шаблон `*.company.ru` как сам пользовательский домен — только конкретное полное доменное имя. Маршрутизационная запись — это отдельно шаблонная CNAME в DNS регистратора.
После активации в конструкторе ссылки выберите домен в группе «Свои домены». Публичный адрес будет вида https://go.company.ru/promo.
Ключи API
Раздел «Ключи API» позволяет выпускать ключи с ограниченными правами для интеграций (CRM, скрипты, CI), ограничивать права и отзывать доступ.
- «Настройки» → «Ключи API» → «Создать ключ».
- Задайте название интеграции и права: «Полный доступ» или выбор нужных разрешений.
- Сохраните секретный ключ сразу после создания — позже он не показывается.
- Для изменения названия или прав используйте «Редактировать», для отключения — «Отозвать ключ».
- Ключ привязан к текущему проекту (области действия) и не работает вне него.
- Ротация ключа делается через отзыв старого и создание нового: секрет не меняется через редактирование.
- Если достигнут лимит ключей проекта, интерфейс покажет ограничение тарифа/плана.
Выбор прав при создании API ключа.
ВНИМАНИЕ: секретный ключ показывается один раз. Не вставляйте ключ в клиентский JavaScript или публичные репозитории; храните в переменных окружения или менеджере секретов.
Удалить проект
Внизу настроек — действие «Удалить проект» с длинным подтверждением.
- «Настройки» → зона удаления → «Удалить проект».
- Дождитесь таймера подтверждения (~10 с) → «Удалить навсегда».
ВНИМАНИЕ: удаление проекта необратимо уничтожает папки и ссылки проекта. Поддомены аккаунта при этом сохраняются. Не путайте с удалением одной ссылки или папки.