Міграція з Dub.co в Elido: що насправді робить імпортер

Імпортер Dub.co в Elido читає ваші посилання через REST API Dub, по 100 за запит, і створює їх на одному домені Elido з тим самим slug. Він переносить slug, URL призначення, заголовок і назви тегів. Він не переносить папки, архівні посилання, історію кліків чи будь-які налаштування посилань. Це ті факти, що мають значення, якщо ви плануєте міграцію.

Свого часу ця стаття стверджувала, що папки Dub згортаються в теги. Для цього оновлення я перечитав імпортер, і це було хибно: код папки взагалі не читає. Ця версія описує, що services/api-core/internal/imports/dub.go робить сьогодні, звірено з опублікованою специфікацією API Dub (доступ 2026-10-02).

Що імпортер просить у Dub

Воркер надсилає GET https://api.dub.co/links?page=N&pageSize=100 з вашим ключем як bearer-токеном. Згідно з документацією Dub щодо ключів API (доступ 2026-10-02), ключ прив'язаний до одного робочого простору й може бути створений лише для читання. Ключа лише для читання цілком досить для цього імпорту, бо воркер лише перелічує посилання й ніколи нічого не пише в Dub.

Відповідь - звичайний масив JSON. Прапорця «є ще» немає, тож воркер запитує сторінки, доки не прийде сторінка коротша за 100 елементів або порожня:

if len(links) == 0 { break }
// ... import each link ...
if len(links) < dubPageSize { break } // last page
page++

Одне застереження зі специфікації самого Dub: параметр page позначено застарілим на користь курсорної пагінації через startingAfter. Він і досі працює, а pageSize приймає до 100. Якщо Dub прибере page, імпортер потребуватиме невеликої зміни, і я очікую, що це проявиться як невдале завдання з чіткою помилкою HTTP, а не як тиха втрата даних.

На сторінці лімітів запитів Dub (доступ 2026-10-02) вказано 60 запитів на хвилину на плані Free і 600 на Pro. Між запитами імпортер вставляє посилання по одному в Postgres, тож на практиці до ліміту Free він не наближається. Повторних спроб він також не має: HTTP 429 або будь-яка відповідь не 200 завершує завдання як невдале з кодом статусу в повідомленні.

Що потрапляє в Elido, поле за полем

Усе інше на посиланні Dub відкидається: опис, зображення соціального прев'ю, термін дії, пароль, гео- та девайс-таргетинг, поля UTM, цілі для iOS і Android, прапорці відстеження конверсій. Якщо посилання залежить від чогось із цього, відновіть його після імпорту. В Elido є власні правила розумних посилань для таргетингу, але ніщо не переносить правила Dub автоматично.

Папки, архівні посилання і домени

Три поняття Dub не обробляються, і кожне може здивувати.

Папки. У схемі посилання Dub папка з'являється лише як рядок folderId. В імпортера немає для нього поля, і він не робить другого виклику, щоб визначити назви папок. В Elido є теги, а не папки, тож навіть майбутній імпортер мав би їх згортати. Сьогодні структура папок губиться. Якщо це важливо, занотуйте папку для кожного slug перед початком, а потім позначте тегами імпортовану партію (фільтруйте за imported:dub) вручну або через API.

Архівні посилання. Endpoint списку Dub приймає параметр showArchived, який типово дорівнює false. Імпортер його ніколи не виставляє, тож архівні посилання не повертаються й не імпортуються. Це розумне типове значення для міграції, але варто знати про нього, якщо ви навмисно тримаєте старі кампанійні посилання в архіві.

Домени посилань. Робочий простір Dub може містити посилання на кількох доменах. Імпортер читає всі, ігнорує поле domain і створює кожне посилання на єдиному домені Elido, який ви обрали. Якщо два домени Dub використовують однаковий ключ, другий потрапляє в конфлікт. Що буде далі, вирішує стратегія конфліктів, тож обирайте її з урахуванням цього.

Конфлікти, ліміти і контракт воркера

Стратегію конфліктів ви обираєте під час запуску завдання:

• suffix пробує mylink-2, mylink-3 і так далі до -50, а тоді відмовляється від цього посилання й рахує його як невдале.
• skip не чіпає наявне посилання Elido й записує slug як пропущений.
• fail зупиняє все завдання на першому конфлікті.

За один запуск воркер зупиняється на 50 000 посилань (MaxLinksPerImport) або через 30 хвилин (ImportRunBudget), залежно від того, що настане раніше. Прогрес зберігається кожні 50 посилань, і панель його опитує. Журнал помилок зберігає щонайбільше 1000 записів. Кожна перевірка slug - це один індексований пошук за (domain_id, slug).

Я не робив бенчмарків імпорту Dub на великому акаунті, тож не наводитиму швидкість у посиланнях за хвилину. Цикл - це одна HTTP-сторінка зі 100 посилань і 100 послідовних вставок, тож тривалість залежить від швидкості відповіді Dub і від вашої бази даних. Спершу протестуйте на малому робочому просторі.

Обробка токена і що буває під час деплою

Ключ подорожує в тілі запиту POST /imports/dub, живе в пам'яті запущеного воркера й ніколи не зберігається: source_token_id у рядку завдання лишається порожнім. До стовпця source_filter завдання потрапляє лише необов'язковий текст workspace_id.

Воркер працює в горутині, відокремленій від HTTP-запиту через context.WithoutCancel. Це тримає його живим після відповіді, а також означає, що деплой або перезапуск убиває його посеред запуску. Завдання планувальника кожні 5 хвилин позначає як невдалий будь-який імпорт у стані running без прогресу 30 хвилин. Повторний запуск безпечний при suffix (ви отримаєте копії з -2 для всього вже імпортованого) і при skip (уже імпортовані slug пропускаються). Відновлення з останньої сторінки поки немає.

Список посилань у демо-просторі із синтетичними даними. Після імпорту фільтруйте за тегом imported:dub, щоб знайти партію.

Короткий чекліст перед запуском

1. Створіть ключ API лише для читання у своєму робочому просторі Dub.
2. Розархівуйте архівні посилання, які хочете зберегти, і занотуйте структуру папок, на яку покладаєтеся.
3. Додайте цільовий домен в Elido та оберіть skip або suffix, знаючи, що всі домени Dub зіллються в цей один.
4. Запустіть імпорт зі сторінки інтеграції на панелі або POST /imports/dub з token, target_domain_id і conflict_strategy.
5. Вибірково звірте slug і призначення з Dub, а тоді оновіть DNS для будь-якого власного домену. Плейбук переходу з Bitly описує порядок змін DNS, який однаковий для будь-якого вендора.

Якщо ви ще вирішуєте, чи переїжджати взагалі, Elido проти Dub порівнює плани й функції, а GDPR для скорочувачів URL пояснює бік резиденції даних. Покрокова інструкція від вендора живе на сторінці міграції з Dub.

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

• Elido проти Dub: SSO, відстеження конверсій, резиденція в ЄС
• Альтернативи Dub: порівняння 6 платформ керування посиланнями
• Випуск міграції з Bitly: воркер, токен, бюджет 30 хвилин
• Випуск міграції з Rebrandly: пагінація по 25 на сторінку
• Випуск міграції з Short.io: пагінація по домену зі 150 на сторінку