8 мин чтенияМиграция

Миграция с Short.io: экспорт, импорт, чек-лист переключения

План миграции с Short.io: варианты экспорта, что переносится, как сопоставляются домены, папки и теги, импортёр Elido, переключение DNS и шаги проверки.

Marius Voß
DevRel · edge infra
Схема конвейера: REST API Short.io слева проходит через воркер импорта Elido в таблицу ссылок, на боковой панели перечислены числовые гарантии воркера (лимит 50 тысяч, бюджет 30 минут, 150 на страницу, токен только в памяти)

Миграция с Short.io состоит из четырёх частей: вытащить ссылки, решить, как домены, папки и теги попадут в новый инструмент, перенести DNS и доказать, что ничего не сломалось. Elido умеет забирать ссылки прямо из API Short.io, поэтому CSV не нужен, но у импортёра есть ограничения, которые стоит знать до начала. Это руководство описывает варианты экспорта, которые документирует Short.io, что импортёр Elido переносит и отбрасывает, порядок переключения без простоя и чек-лист проверки.

Факты о Short.io ниже взяты из собственной документации Short.io, просмотрено 2026-10-02. Поведение Elido проверено по исходному коду импортёра и панели, а не по маркетинговой странице.

Варианты экспорта из Short.io одним взглядом

Есть три способа получить список ссылок из Short.io. От выбранного зависит, что уцелеет.

МетодЧто вы получаетеПодвох
Экспорт CSV (по домену или выбранным ссылкам)ID, короткий URL, путь, исходный URL, название, клики, создано, обновлено, истекает, автор, тегиПо умолчанию не включён; нужно попросить поддержку Short.io включить. Массовый экспорт приходит по электронной почте
Конечная точка списка REST APIВсё перечисленное плюс папка, пароль, клоакинг, тип редиректа, поля UTM, адреса для устройствНужен секретный API-ключ и постраничный проход. Возвращает до 150 ссылок за вызов
Импортёр ElidoАдрес назначения, слаг, название, теги (через вставленный вами API-ключ)По одному домену, и он не читает дополнительные поля строки API

Конечная точка списка - самый богатый источник. Она фильтрует по домену, папке и диапазону дат, сортирует по дате создания и возвращает nextPageToken для постраничного прохода. Поэтому это правильный инструмент для аудита того, что импортёр не перенесёт, - именно эту часть большинство руководств пропускает.

У Short.io также есть импортёр CSV для обратного направления, со столбцами URL, слага, тегов, названия и даты создания (руководство по импорту). Если вы предпочитаете скрипт, у Elido есть конечная точка API для массового создания ссылок, а перечисленные столбцы CSV соответствуют адресу назначения, слагу, названию и тегам.

Шаг 1: аудит до любых переносов

Сначала проведите аудит исходного домена. Я бы не пропускал этот шаг: он дёшев и только он позволяет узнать, каким ссылкам нужна ручная работа, раньше посетителей.

  1. Экспортируйте CSV или пройдите по API и посчитайте ссылки по доменам. Сравните с лимитом 50 000 за запуск.
  2. Отфильтруйте ссылки с expiresAt, password, cloaking: true, адресами для устройств (androidURL, iphoneURL) или разделённым URL. Именно эти ссылки импортёр воссоздаст как обычные редиректы.
  3. Запишите тип редиректа. Short.io позволяет выбрать 301, 302, 307 или 308 для каждой ссылки. Импортёр его не читает, поэтому решите, что вам нужно в Elido. Компромиссы описаны в редиректах 301 и 302.
  4. Заархивируйте столбец кликов. Сохраните CSV; после отмены это единственная запись итогов по каждой ссылке.

Домены и папки: как работает сопоставление

Short.io организует всё под доменом. Elido организует под воркспейсом, а воркспейс владеет доменами.

  • Пользовательский домен, которым вы владеете: добавьте его в воркспейс и измените DNS сами. Импортёр этого не делает.
  • Поддомен Short.io: ссылки импортируются на новый домен Elido, но старые URL на этом поддомене перестают резолвиться.
  • Папка: пересоберите как папку в списке ссылок после импорта. Импортёр не переносит.
  • Тег: переносится, плюс тег imported:shortio.
  • Путь (слаг): переносится, с отброшенным ведущим /.

Здесь важны две детали. Во-первых, импортёр переносит один домен Short.io в один домен Elido за задание. Если у вас три домена, вы запускаете три задания, одно за другим. Во-вторых, импортёр не задаёт папку. Практический приём - отфильтровать список ссылок Elido по тегу Short.io, выбрать ссылки и переместить их в папку. Если папки были вашим главным инструментом организации в Short.io, преобразуйте каждую в тег в Short.io до импорта, чтобы тег поехал вместе со ссылкой.

Список ссылок Elido со столбцами короткой ссылки, адреса назначения, кликов, тегов и папки и панелью All links, Unfiled и New folder над таблицей

Список ссылок Elido в DEMO-воркспейсе с примерами данных (все числа синтетические). Теги и столбец папок - это то место, где оказываются импортированные метаданные Short.io.

Запуск импортёра Elido

Импортёр находится в панели в разделе Integrations, затем Short.io. Страница интеграции и страница миграции с Short.io описывают тот же процесс.

  1. В Short.io создайте секретный API-ключ в разделе Integrations и API. Импортёр только читает.
  2. В Elido откройте карточку миграции Short.io и вставьте ключ. Карточка сообщает, что ключ никогда не сохраняется: он остаётся в памяти на время запуска и сбрасывается по завершении задания.
  3. Введите имя хоста домена Short.io, из которого импортировать, например example.short.gy.
  4. Выберите целевой домен Elido, который уже должен быть добавлен в ваш воркспейс.
  5. Выберите стратегию конфликтов и запустите. Задание опрашивает собственный прогресс каждые две секунды в панели.

Три стратегии конфликтов ведут себя так. Suffix переименовывает конфликтующий слаг в name-2, name-3 и так далее. Skip оставляет существующую ссылку Elido нетронутой и записывает исходную строку в журнал. Fail останавливает всё задание на первой коллизии. Suffix - безопасное значение по умолчанию для первого запуска на пустой домен; используйте skip при повторном запуске после частичного импорта.

Под капотом воркер запрашивает по 150 ссылок на страницу и следует по nextPageToken Short.io, пока тот не закончится. Запуск ограничен 50 000 ссылок и 30 минутами, прогресс записывается каждые 50 ссылок, а журнал ошибок хранит первые 1000 проблемных строк. Ссылка без URL назначения или с пустым слагом записывается как сбой, и запуск продолжается. Названия обрезаются до 200 знаков.

Проверьте первый результат, прежде чем доверять второму домену. Откройте несколько импортированных ссылок, сравните слаг и адрес назначения с CSV из Short.io и только потом ставьте в очередь следующее задание.

Что не переносится

Явно запишите этот список в план проекта. Импортёр читает только поля из первой таблицы выше.

  • Пароли, сроки действия, клоакинг, адреса для устройств и сплит-тесты. Приходят как обычные редиректы. Пересоберите маршрутизацию по геолокации и устройствам как правила умных ссылок. У ссылок Elido также есть собственные поля срока действия и пароля, так что задайте их по списку из аудита.
  • Папки. Пересоберите вручную, см. выше.
  • Тип редиректа. Задайте заново, если вы полагаетесь на поведение 301 или 302.
  • Состояние архива. Импортёр его не проверяет. Сверьте архивные ссылки в вашем CSV с тем, что появилось в Elido.
  • Пиксели и вебхуки. Они настраиваются в Short.io отдельно от ссылок. Создайте их заново в воркспейсе Elido и выпустите новые секреты вебхуков, поскольку подписи в двух продуктах различаются.
  • История кликов. См. следующий раздел.

Что происходит с историей аналитики

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

У вас два честных варианта. Сохраните CSV из Short.io, где есть итог кликов по каждой ссылке, и заархивируйте его с датой переключения как базовый уровень. Либо, если вы на тарифе Enterprise, попросите у Short.io экспорт статистики в S3, который Short.io предлагает по запросу. После переключения раздел аналитики показывает клики по дням, страны, источники переходов и хосты по всему воркспейсу.

Обзор аналитики Elido с графиком кликов по дням и панелями топ стран, топ источников переходов и топ хостов

Обзор аналитики Elido в DEMO-воркспейсе с примерами данных (синтетические числа, а не результаты клиентов). После переключения в этом разделе только клики, обслуженные Elido.

Переключение: безопасный порядок для пользовательских доменов

Ссылки на хосте, которым вы владеете, могут переехать так, что никто не заметит, если соблюдать порядок. Ссылки на поддомене Short.io - нет, потому что вы не контролируете это DNS-имя.

  1. Сначала добавьте хост в Elido. Добавьте его в пользовательские домены, опубликуйте TXT-запись верификации и дождитесь верификации. Механика описана в пользовательский домен с TLS за 5 минут и на странице функции пользовательских доменов.
  2. Импортируйте на этот хост, пока Short.io всё ещё обслуживает боевой трафик. Для посетителей пока ничего не меняется.
  3. Проверьте ссылки в Elido, протестировав слаги на новом edge до смены DNS (см. чек-лист ниже).
  4. Снизьте TTL существующей записи за день до этого, чтобы переключение распространилось быстро.
  5. Измените запись. Руководство Short.io использует A-запись на корне (207.174.61.1 на момент просмотра). Elido использует CNAME на edge.elido.me. CNAME не может стоять на голом корневом домене (RFC 1034), поэтому для корневого хоста нужен ALIAS или сведение CNAME у вашего DNS-провайдера либо переход на поддомен.
  6. Держите Short.io активным ещё один расчётный период как откат. Если что-то выглядит неправильно, верните запись.

Если вам важен поисковый и реферальный трафик, проверьте, что ваши старые короткие URL резолвятся за один переход. Цепочки стоят времени и описаны в цепочках редиректов и SEO.

Чек-лист проверки

Выполните его после распространения DNS на выборке минимум из 50 ссылок или на всех, если их меньше.

  • Число импортированных совпадает с числом в источнике с учётом пропущенных и неудачных строк из журнала ошибок задания.
  • Десять случайных слагов возвращают тот же адрес назначения, что и CSV из Short.io.
  • Ссылки, отмеченные при аудите (срок действия, пароль, правила для устройств), воссозданы и проверены.
  • dig CNAME go.example.com +short возвращает edge Elido, а HTTPS загружается без предупреждения о сертификате.
  • QR-коды и печатные материалы со старым доменом всё ещё резолвятся.
  • Тестовый клик отображается в аналитике Elido.
  • CSV из Short.io с итогами кликов заархивирован в надёжном месте.
  • Вебхуки, пиксели и базовые URL SDK теперь указывают на Elido.

Не каждому аккаунту стоит переезжать. Если вы используете только поддомен Short.io, миграция меняет каждый публичный URL, и работы больше, чем намекает импортёр. Решить помогут сравнительные материалы: Elido против Short.io, более широкий список альтернатив Short.io и очные сравнения Short.io против Bitly и Short.io против Rebrandly. Если вы взвешиваете другой исходный инструмент, план для TinyURL построен по той же структуре.

Готовы сначала попробовать на небольшом домене? Запустите импорт из Short.io с тестовым доменом, сверьте результаты со своим CSV и решайте об остальном по итогам.

Читайте также в блоге

Частые вопросы

Как экспортировать мои ссылки из Short.io?

Short.io документирует два экспорта в CSV: выберите ссылки в меню Branded links и нажмите Export либо откройте настройки домена и выберите Export links, чтобы получить файл по электронной почте. Short.io сообщает, что эта функция по умолчанию не включена, поэтому сначала нужно обратиться в их поддержку. Альтернатива - API, которому одобрение не требуется.

Можно ли сохранить мой пользовательский домен при уходе из Short.io?

Да, если хост принадлежит вам. Добавьте его в Elido, импортируйте на него ссылки, затем измените DNS-запись у регистратора. Старые короткие URL продолжат работать, потому что хост теперь указывает на Elido. Поддомены Short.io, такие как example.short.gy, остаются у Short.io.

Импортирует ли Elido папки Short.io?

Не как папки. Импортёр читает адрес назначения, слаг, название и теги каждой ссылки и добавляет тег imported:shortio. Привязка к папке в эту нагрузку не входит, поэтому пересоберите папки в списке ссылок Elido и используйте теги, чтобы найти, что куда относится.

Можно ли перенести историю кликов Short.io?

Нет. Импортёр создаёт ссылки, а не события кликов. Экспорт CSV из Short.io включает столбец clicks с итогом по каждой ссылке, который стоит заархивировать, а Short.io по запросу предлагает экспорт статистики в S3 на тарифах Enterprise. Новые клики в Elido считаются с момента переключения.

Сколько длится импорт из Short.io?

Импортёр читает по 150 ссылок за запрос и останавливается на 50 000 ссылок или 30 минутах за запуск. Несколько тысяч ссылок обычно завершаются за минуты, в зависимости от скорости ответов Short.io. Более крупные домены нужно разбивать.

Переносятся ли ссылки Short.io с паролем или сроком действия?

Импортёр не читает пароли, сроки действия, клоакинг и адреса для устройств. Составьте список таких ссылок через API Short.io до переключения и воссоздайте поведение в Elido, например с помощью правил умных ссылок и срока действия ссылки.

Попробуйте Elido

Вставьте URL - получите короткую ссылку

Без регистрации. Ссылка живёт 30 дней. Зарегистрируйтесь, чтобы оставить её навсегда.

Бесплатно, без регистрации · 2 в день

Попробуйте Elido

URL-сокращатель с хостингом в ЕС: собственные домены, глубокая аналитика, открытый API. Бесплатный тариф - без банковской карты.

Теги
short.io migration
migrate from short.io
short.io export links
short.io custom domain migration
short.io to elido
short.io csv export

Читать дальше