Короткая ссылка помогает публиковать удобные URL и фиксировать клики в аналитике проекта.
Что нужно заранее
- создан проект;
- активен тариф, в котором доступна услуга shortlink;
- есть системный домен или подключён собственный домен;
- исходная ссылка открывается без ошибок.
[ТУТ СКРИНШОТ: форма создания короткой ссылки в проекте]
Порядок действий
- Откройте проект.
- Перейдите в раздел коротких ссылок.
- Нажмите создание ссылки.
- Вставьте исходный URL.
- Выберите домен, если доступно несколько.
- Укажите alias вручную или оставьте автогенерацию.
- Сохраните ссылку.
Исходный URL:
https://example.com/catalog/product-1?utm_source=cdp
Alias:
product-1
Ожидаемый short URL:
https://go.example.com/product-1Проверка
- Откройте короткую ссылку в новой вкладке.
- Убедитесь, что произошёл redirect на исходный URL.
- Вернитесь в CDP и проверьте статистику кликов, если она доступна.
- Если статистики нет мгновенно, подождите обновления или проверьте event/logs.
Если ссылка не создаётся
- ошибка 402 — проверьте лимит тарифа;
- ошибка валидации URL — проверьте протокол
https://; - домен недоступен — проверьте статус домена;
- alias занят — выберите другой alias.
Контрольный чек-лист
- Проверьте, что вы находитесь в правильном проекте, а не в соседнем тестовом проекте.
- Проверьте роль пользователя: часть кнопок видна только администратору.
- Откройте DevTools → Network и найдите запрос к
/v1/.... - Скопируйте точный текст ошибки, HTTP-статус и время возникновения.
- Если операция связана с лимитом, откройте страницу лимитов до повторного запуска.
Что приложить к задаче разработчику
Чтобы проблему можно было быстро воспроизвести, приложите URL страницы, projectUuid, время ошибки, скриншот интерфейса, скриншот Network-запроса и архив логов. Для ошибок bootstrap отдельно проверьте, были ли в gateway.log не только GET, но и POST/PUT запросы.
[ТУТ СКРИНШОТ: Network-запрос с route, HTTP-статусом и response body]
