9 min de leituraMigração

Migração do Short.io: exportação, importação e troca

Planeje uma migração do Short.io: opções de exportação, o que acompanha, mapeamento de domínios, pastas e tags, importador do Elido, troca de DNS e verificação.

Marius Voß
DevRel · edge infra
Diagrama de pipeline: a API REST do Short.io à esquerda fluindo pelo worker de importação do Elido até a tabela de links, com um painel lateral listando as garantias numéricas do worker (limite de 50k, orçamento de 30 min, 150 por página, token só na memória)

Uma migração do Short.io tem quatro partes: tirar seus links de lá, decidir como domínios, pastas e tags chegam à nova ferramenta, mover o DNS e provar que nada quebrou. O Elido pode puxar links direto da API do Short.io, então nenhum CSV é necessário, mas o importador tem limites que você deve conhecer antes de começar. Este guia cobre as opções de exportação que o Short.io documenta, o que o importador do Elido leva e o que deixa para trás, uma ordem de troca que evita indisponibilidade e uma checklist de verificação.

Os fatos sobre o Short.io abaixo vêm da própria documentação do Short.io, acessada em 2026-10-02. O comportamento do Elido foi conferido com o código-fonte do importador e o painel, não com uma página de marketing.

Opções de exportação do Short.io em resumo

Você tem três formas de tirar sua lista de links do Short.io. Qual você escolher decide o que sobrevive.

MétodoO que você recebePegadinha
Exportação CSV (por domínio ou links selecionados)ID, URL curta, path, URL original, título, cliques, criado, atualizado, expira, criado por, tagsNão vem ativada por padrão; você pede ao suporte do Short.io para ativá-la. A exportação em massa chega por e-mail
Endpoint de listagem da API RESTTudo o que está acima mais pasta, senha, cloaking, tipo de redirecionamento, campos UTM, URLs por dispositivoPrecisa de uma chave de API secreta e paginação. Retorna até 150 links por chamada
Importador do ElidoDestino, slug, título, tags (pela chave de API que você cola)Por domínio, e não lê os campos extras da linha da API

O endpoint de listagem é a fonte mais rica. Ele filtra por domínio, pasta e intervalo de datas, ordena por data de criação e retorna um nextPageToken para paginação. Isso o torna a ferramenta certa para uma auditoria das coisas que o importador não leva, que é a parte que a maioria dos guias pula.

O Short.io também tem um importador de CSV para o sentido oposto, com colunas para URL, slug, tags, título e data de criação (guia de importação). Se você prefere automatizar com script, o Elido tem um endpoint de API de criação de links em massa, e as colunas do CSV acima correspondem a destino, slug, título e tags.

Passo 1: audite antes de mover qualquer coisa

Faça primeiro uma auditoria do domínio de origem. Eu não pularia esta etapa: ela é barata e é a única forma de descobrir quais links precisam de trabalho manual antes que os visitantes descubram.

  1. Exporte o CSV ou percorra a API e conte os links por domínio. Compare com o limite de 50.000 por execução.
  2. Filtre os links com expiresAt, password, cloaking: true, URLs por dispositivo (androidURL, iphoneURL) ou uma URL dividida. Esses são os links que o importador vai recriar como redirecionamentos simples.
  3. Anote o tipo de redirecionamento. O Short.io deixa você escolher 301, 302, 307 ou 308 por link. O importador não o lê, então decida o que você quer no Elido. Os trade-offs estão em redirecionamentos 301 vs 302.
  4. Arquive a coluna de cliques. Guarde o CSV; ele é o único registro dos totais por link depois que você cancelar.

Domínios e pastas: como funciona o mapeamento

O Short.io organiza tudo sob um domínio. O Elido organiza sob um workspace, e um workspace é dono dos domínios.

  • Domínio personalizado que você possui: adicione-o ao workspace e altere o DNS você mesmo. O importador não faz isso.
  • Subdomínio do Short.io: os links são importados para um novo domínio do Elido, mas as URLs antigas nesse subdomínio deixam de resolver.
  • Pasta: reconstrua como pasta na lista de links depois da importação. O importador não a leva.
  • Tag: levada, mais uma tag imported:shortio.
  • Path (slug): levado, com a / inicial removida.

Dois detalhes importam aqui. Primeiro, o importador leva um domínio do Short.io para um domínio do Elido por job. Se você tem três domínios, inicia três jobs, um depois do outro. Segundo, o importador não define pasta. O padrão prático é filtrar a lista de links do Elido por uma tag do Short.io, selecionar os links e movê-los para uma pasta. Se as pastas eram sua principal ferramenta de organização no Short.io, converta cada uma em uma tag no Short.io antes da importação para que a tag viaje com o link.

Lista de links do Elido mostrando colunas de link curto, destino, cliques, tags e pasta, com uma barra Todos os links, Sem pasta e Nova pasta acima da tabela

A lista de links do Elido em um workspace de DEMONSTRAÇÃO com dados de exemplo (todos os números são sintéticos). Tags e a coluna de pasta são onde os metadados importados do Short.io vão parar.

Rodando o importador do Elido

O importador fica no painel em Integrações, depois Short.io. A página da integração e a página de migrar do Short.io descrevem o mesmo fluxo.

  1. No Short.io, crie uma chave de API secreta em Integrations e API. O importador só lê.
  2. No Elido, abra o card de migração do Short.io e cole a chave. O card informa que a chave nunca é armazenada: ela fica na memória durante a execução e é descartada quando o job termina.
  3. Digite o hostname do domínio do Short.io de onde importar, por exemplo example.short.gy.
  4. Escolha o domínio de destino do Elido, que já precisa estar adicionado ao seu workspace.
  5. Escolha uma estratégia de conflito e inicie. O job consulta o próprio progresso a cada dois segundos no painel.

As três estratégias de conflito se comportam assim. Suffix renomeia um slug em colisão para name-2, name-3 e assim por diante. Skip deixa o link existente do Elido em paz e registra a linha de origem no log. Fail interrompe o job inteiro na primeira colisão. Suffix é o padrão seguro para uma primeira execução em um domínio vazio; use skip ao reexecutar depois de uma importação parcial.

Por baixo dos panos, o worker pede 150 links por página e segue o nextPageToken do Short.io até acabar. Uma execução tem limite de 50.000 links e 30 minutos, o progresso é gravado a cada 50 links e o log de erros guarda as primeiras 1.000 linhas com problema. Um link sem URL de destino ou com slug vazio é registrado como falha e a execução continua. Os títulos são cortados em 200 caracteres.

Confira o primeiro resultado antes de confiar no segundo domínio. Abra um punhado de links importados, compare slug e destino com o CSV do Short.io e só então enfileire o próximo job.

O que não acompanha

Seja explícito sobre esta lista no seu plano de projeto. O importador lê apenas os campos da primeira tabela acima.

  • Senhas, datas de expiração, cloaking, URLs por dispositivo e testes divididos. Chegam como redirecionamentos simples. Reconstrua o roteamento por geografia e dispositivo como regras de smart link. Os links do Elido também têm seus próprios campos de expiração e senha, então defina-os a partir da sua lista de auditoria.
  • Pastas. Reconstrua à mão, veja acima.
  • Tipo de redirecionamento. Defina de novo se você depende do comportamento de 301 versus 302.
  • Estado arquivado. O importador não o verifica. Confira os links arquivados no seu CSV com o que aparece no Elido.
  • Pixels e webhooks. São configurados separadamente dos links no Short.io. Recrie-os no workspace do Elido e emita novos segredos de webhook, já que as assinaturas diferem entre os dois produtos.
  • Histórico de cliques. Veja a próxima seção.

O que acontece com o histórico de analytics

O histórico por clique não se move. O importador cria links e nada mais, então o Elido começa a contar a partir do primeiro clique que serve. Isso vale para todo importador do painel do Elido e para a maioria das ferramentas da categoria.

Você tem duas opções honestas. Guarde o CSV do Short.io, que traz um total de cliques por link, e arquive-o com a data da troca como linha de base. Ou, se você está em um plano Enterprise, peça ao Short.io a exportação de estatísticas para S3, que o Short.io oferece sob solicitação. Depois da troca, a visão de analytics mostra cliques por dia, países, referenciadores e hosts de todo o workspace.

Visão geral de analytics do Elido com um gráfico de cliques por dia e painéis de principais países, principais referenciadores e principais hosts

A visão geral de analytics do Elido em um workspace de DEMONSTRAÇÃO com dados de exemplo (números sintéticos, não resultados de clientes). Depois da troca, esta visão contém apenas os cliques servidos pelo Elido.

Troca: uma ordem segura para domínios personalizados

Links em um hostname que você possui podem mudar sem que ninguém perceba, se você seguir a ordem. Links em um subdomínio do Short.io não podem, porque você não controla esse nome de DNS.

  1. Adicione o hostname ao Elido primeiro. Adicione-o em domínios personalizados, publique o registro TXT de verificação e espere a verificação. A mecânica está em TLS de domínio personalizado em 5 minutos e na página do recurso de domínios personalizados.
  2. Importe para esse hostname enquanto o Short.io ainda serve o tráfego de produção. Nada muda para os visitantes ainda.
  3. Verifique os links no Elido testando os slugs contra o novo edge antes de o DNS mudar (veja a checklist abaixo).
  4. Reduza o TTL do registro existente um dia antes, para que a troca se propague rápido.
  5. Altere o registro. O guia do Short.io usa um registro A na raiz (207.174.61.1 quando acessado). O Elido usa um CNAME para edge.elido.me. Um CNAME não pode ficar no apex puro (RFC 1034), então para um hostname de apex você precisa de ALIAS ou CNAME flattening no seu provedor de DNS, ou passa para um subdomínio.
  6. Mantenha o Short.io ativo por um ciclo de cobrança como rollback. Se algo parecer errado, reverta o registro.

Se você também se importa com o tráfego de busca e de referência, confira se suas URLs curtas antigas resolvem em um salto só. Cadeias custam tempo e são tratadas em cadeias de redirecionamento e SEO.

Checklist de verificação

Rode isto depois que o DNS se propagar, em uma amostra de pelo menos 50 links ou em todos os links, se você tiver menos.

  • A contagem importada bate com a contagem de origem, depois de contabilizadas as linhas ignoradas e com falha do log de erros do job.
  • Dez slugs aleatórios retornam o mesmo destino do CSV do Short.io.
  • Os links que você sinalizou na auditoria (expiração, senha, regras de dispositivo) foram recriados e testados.
  • dig CNAME go.example.com +short retorna o edge do Elido e o HTTPS carrega sem aviso de certificado.
  • QR codes e material impresso que usam o domínio antigo ainda resolvem.
  • Um clique de teste aparece no analytics do Elido.
  • O CSV do Short.io com os totais de cliques está arquivado em um lugar durável.
  • Webhooks, pixels e URLs base de SDKs agora apontam para o Elido.

Nem toda conta deve migrar. Se você só usa um subdomínio do Short.io, uma migração muda todas as URLs públicas, e o trabalho é maior do que o importador sugere. Os posts de comparação ajudam você a decidir: Elido vs Short.io, a lista mais ampla de alternativas ao Short.io e os confrontos diretos Short.io vs Bitly e Short.io vs Rebrandly. Se você está avaliando outra ferramenta de origem, o playbook do TinyURL segue a mesma estrutura.

Pronto para testar primeiro em um domínio pequeno? Inicie a importação do Short.io com um domínio de teste, confira os resultados com o seu CSV e decida o resto a partir daí.

Relacionados no blog

Perguntas frequentes

Como exporto meus links do Short.io?

O Short.io documenta duas exportações em CSV: selecione links no menu Branded links e clique em Export, ou abra as configurações do domínio e escolha Export links para receber um arquivo por e-mail. O Short.io diz que o recurso não vem ativado por padrão, então você entra em contato com o suporte deles primeiro. A API é a alternativa e não precisa de aprovação.

Posso manter meu domínio personalizado ao sair do Short.io?

Sim, se você é dono do hostname. Adicione-o ao Elido, importe os links para ele e depois altere o registro DNS no seu registrador. As URLs curtas antigas continuam funcionando porque o hostname agora aponta para o Elido. Subdomínios do Short.io, como example.short.gy, ficam com o Short.io.

O Elido importa as pastas do Short.io?

Não como pastas. O importador lê o destino, o slug, o título e as tags de cada link e adiciona uma tag imported:shortio. A atribuição de pasta não faz parte desse payload, então reconstrua as pastas na lista de links do Elido e use as tags para achar o que pertence a cada uma.

Posso mover meu histórico de cliques do Short.io?

Não. O importador cria links, não eventos de clique. A exportação CSV do Short.io inclui uma coluna de cliques com o total por link, que vale a pena arquivar, e o Short.io oferece uma exportação de estatísticas para S3 em planos Enterprise sob solicitação. Os novos cliques no Elido contam a partir da troca.

Quanto tempo leva uma importação do Short.io?

O importador lê 150 links por requisição e para em 50.000 links ou 30 minutos por execução. Alguns milhares de links costumam terminar em minutos, dependendo da velocidade de resposta do Short.io. Domínios maiores precisam ser divididos.

Links do Short.io protegidos por senha ou com expiração migram?

O importador não lê senhas, datas de expiração, cloaking nem destinos por dispositivo. Faça uma lista desses links pela API do Short.io antes da troca e recrie o comportamento no Elido, por exemplo com regras de smart link e expiração de link.

Experimente Elido

Cole uma URL, obtenha um link curto

Sem cadastro. O link vive 30 dias. Cadastre-se para mantê-lo para sempre.

Grátis, sem necessidade de registo · 2 por dia

Experimente o Elido

Encurtador de URL hospedado na UE: domínios personalizados, análises profundas e API aberta. Plano gratuito - sem cartão de crédito.

Tags
short.io migration
migrate from short.io
short.io export links
short.io custom domain migration
short.io to elido
short.io csv export

Continuar lendo