Проект и домены
Имя проекта, брендированные поддомены и опасная зона удаления.
Настройки проекта
Вкладка «Настройки»: слева «Главная», «Поддомены», «Свои домены», «Ключи API» и блок командного доступа.
- Откройте «Настройки».
- На «Главной» измените название и описание проекта.
- Сохраните изменения в интерфейсе заголовка/формы.
Настройки проекта: имя, описание, удаление.
Поддомены
Поддомен даёт URL вида https://имя.<домен-сервиса>/…. Поддомены принадлежат аккаунту и могут использоваться в разных проектах.
- «Настройки» → «Поддомены» → «+ Поддомен».
- Задайте имя → «Создать».
- В конструкторе ссылки выберите этот поддомен.
- Бейджи: «здесь» — используется ссылками текущего проекта; «в других местах» — в других проектах; «удалён · можно вернуть» — soft-delete.
- После удаления поддомена ссылки на нём перестают резолвиться; в карточке статус «Поддомен удалён».
- «Восстановить» возвращает поддомен; ссылки снова работают, кроме вручную выключенных.
Список поддоменов и создание.
WARNING: «Удалить поддомен» сразу ломает публичные URL на этом имени, пока не восстановите. Перед удалением проверьте, какие ссылки на него завязаны.
Свои домены
Собственный FQDN (например go.company.ru) вместо поддомена на зоне сервиса. После TXT-подтверждения владения и wildcard CNAME ссылки открываются на вашем домене.
- «Настройки» → «Свои домены» → «+ Домен» → укажите FQDN без https://.
- В DNS добавьте TXT-запись владения (шаг 1 инструкции).
- Добавьте CNAME на wildcard `*.ваша-зона` → edge сервиса (шаг 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 на apex (`@`) у большинства регистраторов нельзя. Нужен wildcard: Host `*.company.ru` → Value `edge.kkoroch.ru` (точный target — в инструкции). Wildcard покрывает и go.company.ru, и другие поддомены зоны. Если регистрируете сам apex (company.ru), дополнительно может понадобиться A/ALIAS на `@` — см. подсказку в UI.
| Тип домена | Type | Host | Value |
|---|---|---|---|
| Поддомен go.company.ru | CNAME | *.company.ru | edge.kkoroch.ru |
| Apex company.ru | CNAME | *.company.ru | edge.kkoroch.ru |
| Apex bare (@), опционально | A / ALIAS | @ | IP / alias edge |
DNS-панель: wildcard CNAME `*.зона` на edge сервиса.
- Поддомен сервиса и свой домен взаимоисключающи для одной ссылки.
- Статусы: «Ожидает TXT» → «Нужен CNAME» → «Активен». Только active можно выбрать в конструкторе.
- Удаление домена деактивирует ссылки на нём (статус «Домен удалён»).
- Лимит своих доменов задаётся тарифом (на Free+ часто 0).
- Между проверками DNS — пауза ~15 с.
Домен в статусе «Активен» после успешной проверки DNS.
WARNING: Записи DNS часто вступают в силу не сразу (минуты, иногда до нескольких часов из‑за TTL и кеша резолверов). Если после «Проверить DNS» статус ещё не «Активен» — подождите и повторите проверку; повторно сохранять записи обычно не нужно.
WARNING: Нельзя зарегистрировать wildcard `*.company.ru` как сам custom domain — только конкретный FQDN. Routing-запись — это отдельно wildcard CNAME в DNS регистратора.
После активации в конструкторе ссылки выберите домен в группе «Свои домены». Публичный URL будет вида https://go.company.ru/promo.
Ключи API
Раздел «Ключи API» позволяет выпускать scope-ключи для интеграций (CRM, скрипты, CI), ограничивать права и отзывать доступ.
- «Настройки» → «Ключи API» → «Создать ключ».
- Задайте название интеграции и права: «Полный доступ» или выбор нужных grants.
- Сохраните secret сразу после создания — позже он не показывается.
- Для изменения названия/прав используйте «Редактировать», для отключения — «Отозвать ключ».
- Ключ привязан к текущему проекту (scope) и не работает вне него.
- Ротация ключа делается через отзыв старого и создание нового: секрет не меняется через редактирование.
- Если достигнут лимит ключей проекта, UI покажет ограничение тарифа/плана.
Выбор прав при создании API ключа.
WARNING: secret показывается один раз. Не вставляйте ключ в клиентский JS или публичные репозитории; храните в переменных окружения или менеджере секретов.
Удалить проект
Внизу настроек — действие «Удалить проект» с длинным подтверждением.
- «Настройки» → зона удаления → «Удалить проект».
- Дождитесь таймера подтверждения (~10 с) → «Удалить навсегда».
WARNING: удаление проекта необратимо уничтожает папки и ссылки проекта. Поддомены аккаунта при этом сохраняются. Не путайте с удалением одной ссылки или папки.