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

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

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

Marius Voß
DevRel · edge infra

Миграция с 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Всё перечисленное плюс папка, пароль, cloaking, тип редиректа, поля UTM, адреса для устройствНужен секретный API-ключ и постраничный обход. Возвращает до 150 ссылок за вызов
Импортёр ElidoАдрес назначения, слаг, заголовок, теги (через вставленный вами API-ключ)По одному домену, и он не читает дополнительные поля строки API

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

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

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

Шаг 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. Сохраните столбец clicks. Храните CSV: после отмены тарифа это единственная запись итогов по каждой ссылке.

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

Short.io организует всё под доменом. Elido организует под рабочим пространством, а домены принадлежат рабочему пространству.

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

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

Список ссылок Elido со столбцами короткой ссылки, адреса назначения, кликов, тегов и папки и панелью «Все ссылки», «Без папки» и «Новая папка» над таблицей

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

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

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

  1. В Short.io создайте секретный API-ключ в разделе Integrations and 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 проблемных строк. Ссылка без адреса назначения или с пустым слагом записывается как ошибка, и запуск продолжается. Заголовки обрезаются до 200 символов.

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

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

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

  • Пароли, сроки действия, cloaking, адреса для устройств и сплит-тесты. Они приходят как обычные редиректы. Маршрутизацию по геолокации и устройствам пересоберите как правила умных ссылок. У ссылок 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 flattening у вашего 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 vs Short.io, более широкий список альтернатив Short.io и очные сравнения Short.io vs Bitly и Short.io vs 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 с общим числом по каждой ссылке, его стоит сохранить, а экспорт статистики в S3 Short.io предоставляет по запросу на тарифах Enterprise. Новые клики в Elido считаются с момента переключения.

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

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

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

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

Попробуйте Elido

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

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

Нужен бесплатный аккаунт. Бесплатный план включает всего 25 ссылок. Уже есть аккаунт? Войти

Попробуйте 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

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