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

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

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

Варіанти експорту Short.io одним поглядом

Є три способи отримати список посилань із Short.io. Який ви оберете, визначає, що вціліє.

Endpoint списку - найбагатше джерело. Він фільтрує за доменом, папкою й діапазоном дат, сортує за датою створення й повертає nextPageToken для посторінкової вибірки. Це робить його правильним інструментом для аудиту того, що імпортер не перенесе, а цю частину більшість посібників пропускає.

Short.io також має імпортер CSV для зворотного напрямку, з колонками URL, слаг, теги, назва й дата створення (посібник з імпорту). Якщо ви волієте скриптувати, в Elido є endpoint API масового створення посилань, а наведені вище колонки CSV зіставляються з ціллю, слагом, назвою й тегами.

Крок 1: аудит до того, як щось переносити

Спершу проведіть аудит вихідного домену. Я б не пропускав цей крок: він дешевий, і це єдиний спосіб дізнатися, які посилання потребують ручної роботи, раніше за відвідувачів.

1. Експортуйте CSV або пройдіть API посторінково й порахуйте посилання на домен. Порівняйте з лімітом 50 000 за запуск.
2. Відфільтруйте посилання з expiresAt, password, cloaking: true, URL для пристроїв (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 в 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 й лише тоді ставте в чергу наступну задачу.

Що не переноситься

Будьте явними щодо цього списку у своєму плані проєкту. Імпортер читає лише поля з першої таблиці вище.

• Паролі, дати завершення, клоакінг, URL для пристроїв і спліт-тести. Вони приходять як прості редиректи. Відбудуйте маршрутизацію за геолокацією й пристроєм як правила розумних посилань. Посилання Elido також мають власні поля терміну дії й пароля, тож задайте їх зі свого списку аудиту.
• Папки. Відбудуйте вручну, див. вище.
• Тип редиректу. Задайте його знову, якщо ви покладаєтеся на поведінку 301 проти 302.
• Архівований стан. Імпортер його не перевіряє. Звірте архівовані посилання у вашому CSV із тим, що з'являється в Elido.
• Пікселі й вебхуки. Їх налаштовують окремо від посилань у Short.io. Створіть їх заново в робочому просторі Elido й випустіть нові секрети вебхуків, бо підписи відрізняються між двома продуктами.
• Історія кліків. Див. наступний розділ.

Що відбувається з історією аналітики

Історія окремих кліків не переноситься. Імпортер створює посилання й більше нічого, тож Elido починає рахувати від першого кліка, який обслужить. Це правда для кожного імпортера в панелі Elido й для більшості інструментів категорії.

У вас два чесні варіанти. Збережіть CSV Short.io, що містить підсумок кліків на посилання, і заархівуйте його з датою перемикання як базову лінію. Або, якщо ви на тарифі Enterprise, попросіть у Short.io експорт статистики в S3, який Short.io пропонує на запит. Після перемикання перегляд аналітики показує кліки за день, країни, реферерів і хости для всього робочого простору.

Огляд аналітики 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 проти Short.io, ширший список альтернатив Short.io і прямі порівняння Short.io проти Bitly та Short.io проти Rebrandly. Якщо ви зважуєте інший вихідний інструмент, посібник з TinyURL має ту саму структуру.

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

Читайте також у блозі

• Elido проти Short.io: ціни, команди й резидентність в ЄС у 2026
• Альтернативи Short.io
• Short.io проти Bitly
• Short.io проти Rebrandly
• TLS для власного домену за 5 хвилин
• Міграція з TinyURL: що переїжджає, що лишається, що ламається