УслугиТарифыДокументацияHelpБлогГлоссарийAPI Войти

Как создать короткую ссылку

Справочная статья CDP I-LIM.
Версия: v2Дата: 01.01.2026

Короткая ссылка помогает публиковать удобные URL и фиксировать клики в аналитике проекта.

Что нужно заранее

  • создан проект;
  • активен тариф, в котором доступна услуга shortlink;
  • есть системный домен или подключён собственный домен;
  • исходная ссылка открывается без ошибок.

[ТУТ СКРИНШОТ: форма создания короткой ссылки в проекте]

Порядок действий

  1. Откройте проект.
  2. Перейдите в раздел коротких ссылок.
  3. Нажмите создание ссылки.
  4. Вставьте исходный URL.
  5. Выберите домен, если доступно несколько.
  6. Укажите alias вручную или оставьте автогенерацию.
  7. Сохраните ссылку.
Исходный URL:
  https://example.com/catalog/product-1?utm_source=cdp

Alias:
  product-1

Ожидаемый short URL:
  https://go.example.com/product-1

Проверка

  1. Откройте короткую ссылку в новой вкладке.
  2. Убедитесь, что произошёл redirect на исходный URL.
  3. Вернитесь в CDP и проверьте статистику кликов, если она доступна.
  4. Если статистики нет мгновенно, подождите обновления или проверьте 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]

Что именно решает эта статья

Эта инструкция помогает создать короткую ссылку и проверить редирект. После выполнения шагов пользователь должен понимать, где находится нужный экран, какую кнопку нажать, какие поля заполнить и по какому признаку проверить, что действие завершилось успешно.

[ТУТ ИЗОБРАЖЕНИЕ ПОКАЗЫВАЮЩЕЕ страницу коротких ссылок с формой создания, доменом, slug и статистикой переходов, при этом стрелками или рамками выделены главный раздел меню и основная кнопка действия]

Пошаговый сценарий

  1. Откройте проект. Перейдите в рабочий проект CDP, потому что большинство действий привязаны к projectUuid и правам пользователя.
  2. Найдите нужный раздел. Откройте пункт меню, который относится к теме статьи: Help.
  3. Проверьте обязательные поля. Не запускайте действие, пока не заполнены поля, без которых система не сможет сохранить настройку или выполнить проверку.
  4. Запустите действие. Нажмите основную кнопку создания, запуска, проверки или сохранения. Если кнопка неактивна, вернитесь к обязательным полям и правам доступа.
  5. Проверьте результат. Убедитесь, что появилась карточка, строка в таблице, статус успешного выполнения или понятное сообщение об ошибке.

[ТУТ ИЗОБРАЖЕНИЕ ПОКАЗЫВАЮЩЕЕ модальное окно или форма из этой статьи, заполненные примерными корректными данными; обязательные поля отмечены рамками]

Как читать результат

Смотрите не только на общий статус. В CDP важны детали: дата запуска, пользователь, проект, статус обработки, текст ошибки, связанные сущности и действия, которые можно выполнить дальше. Если результат связан с лимитами тарифа, проверяйте страницу лимитов и сообщение 402. Если результат связан с внешним сервисом, проверяйте подключение, ключи и журнал выполнения.

  • Успешный статус означает, что CDP приняла действие и сохранила результат.
  • Предупреждение означает, что действие выполнено, но есть риск неполного результата или неправильной настройки.
  • Ошибка требует исправления входных данных, прав доступа, лимита тарифа или внешнего подключения.

[ТУТ ИЗОБРАЖЕНИЕ ПОКАЗЫВАЮЩЕЕ готовый результат после выполнения действия: таблица, карточка или отчёт со статусом, датой, кнопкой открытия деталей и блоком ошибок]

Частые ошибки

  • Действие запускают не в том проекте, поэтому данные не появляются там, где их ожидают.
  • Пользователь не имеет нужной роли или доступа к проекту.
  • Не заполнено обязательное поле, но пользователь пытается сохранить форму.
  • Ожидается мгновенный результат там, где проверка или сбор данных выполняется асинхронно.
  • Ошибка 402 воспринимается как техническая поломка, хотя чаще всего это лимит тарифа или неподключённая возможность.

Контрольный список перед обращением в поддержку

  1. Сделайте скрин страницы с ошибкой и открытыми деталями.
  2. Скопируйте точный текст ошибки и время возникновения.
  3. Укажите projectUuid, если он отображается в адресе страницы.
  4. Проверьте, повторяется ли проблема после обновления страницы.
  5. Если проблема связана с файлом, отчётом или логами, скачайте файл результата и приложите его к задаче.