Ferramenta / Links

Encurtador de URL

O Encurtador de URL da Kitly guarda um destino público na Kitly e devolve um redirecionamento curto. Esta é a única ferramenta atual que precisa dos servidores da Kitly para o resultado.
Orientações publicadas pela Kitly

Como criar um link curto

Use links curtos por conveniência, mas deixe o destino claro e teste o redirecionamento antes de compartilhar em escala.

  1. Confira o destino

    Abra primeiro a URL pública HTTP ou HTTPS final e confirme se ela está correta, segura e funciona bem no celular.

  2. Escolha um slug opcional

    Deixe o campo vazio para gerar um código automático ou informe um nome curto em minúsculas com letras, números e hífens.

  3. Crie e teste

    Gere o link, abra em uma nova aba e confirme o redirecionamento antes de usá-lo em documento, perfil, QR code ou campanha.

Compartilhamento mais seguro

  • Diga para onde o link leva quando o contexto da mensagem não deixa o destino evidente.
  • Mantenha um registro da URL original porque um link compacto é mais difícil de auditar visualmente.
  • Use slugs personalizados que continuem compreensíveis e não exponham nomes privados nem segredos de campanha.

Notas de serviço e privacidade

  • Links curtos dependem dos servidores e do armazenamento da Kitly e não redirecionam durante uma indisponibilidade.
  • A URL de destino, o código curto, horários e metadados limitados de segurança são processados para operar e proteger o serviço.
  • Ainda não é possível editar ou excluir links em um painel de autoatendimento; confira o destino antes de criar.

Orientações práticas

Estes estados mostram o que o encurtador realmente devolve para um slug personalizado, uma colisão, um destino bloqueado, um limite de taxa e um link desativado. O arquivo de exemplo registra uma verificação em banco local. Não é um link de produção, e esta página não edita nem expira um link depois da criação.

O formulário precisa de JavaScript para enviar o destino à Kitly e mostrar o resultado. As regras e os estados registrados abaixo continuam legíveis sem JavaScript. Criar um link ainda exige o servidor.

Estados de link registrados

Nenhum link curto foi criado para esta página, nem em produção nem de novo no armazenamento local. O par 201 e 302 é a verificação em D1 local de 11 de outubro de 2026.

Slug personalizado que redirecionou localmente

Um destino HTTPS público e o slug av02-valid foram gravados no D1 local. A criação devolveu 201, e abrir o código devolveu 302 para esse mesmo destino.

URL longa

https://example.com/path?x=1
Configurações
Slug personalizado av02-valid

Resultado observado

O POST devolveu 201 com code av02-valid, shortUrl <request-origin>/s/av02-valid e targetUrl https://example.com/path?x=1. GET /s/av02-valid devolveu 302 para https://example.com/path?x=1.

O que conferir

O código curto é um redirecionamento, não uma cópia da página de destino. O alvo gravado manteve o caminho e a consulta porque o analisador de URL não precisou acrescentar nada. Um valor só com o host, como https://example.com, é gravado como https://example.com/. Diga às pessoas para onde o link leva; o código em si não mostra o destino.

Ressalvas

  • Este código foi observado no D1 local. Não espere que https://kitlyapp.com/s/av02-valid exista.
  • Não há edição, expiração nem exclusão em autoatendimento. O redirecionamento permanece até a linha ser desativada no armazenamento.

Arquivos do exemplo

  • local-response-states.json Auxílio de inspeção com a observação local 201/302 e os corpos JSON desta rota. Não é um link curto ativo.

Colisões e slugs que o servidor não atribui

O slug personalizado é opcional. Quando você informa um, ele precisa seguir o padrão, ficar fora da lista reservada e estar livre.

Casos de slug

Slug em uso: 409 slug_taken. Slug reservado admin: 409 reserved_slug. Curto demais, pontuação ou hífen no início: 400 invalid_slug.
Configurações
Tamanho 3–64 caracteres
Caracteres Letras minúsculas, números e hífens
Extremidades Precisa começar e terminar com letra ou número

Resultado observado

Uma colisão local devolveu HTTP 409. As falhas de slug reservado e de padrão são os status que esta rota devolve; elas não foram enviadas de novo para esta página.

O que conferir

O formulário coloca em minúsculas o que você digita. Deixar o campo vazio pede ao servidor um código de 7 caracteres. admin, api, tools, en, pt e es são reservados; o conjunto completo está na lista vinculada. Um slug em uso significa que esse código já existe. Escolha outro ou deixe o campo vazio. Nenhum dos dois resultados cria um segundo link.

Ressalvas

  • O status da colisão foi registrado localmente em 11 de outubro de 2026. Os corpos de slug reservado e de slug inválido foram copiados da rota atual.
  • Um campo vazio é válido. Ele não é o slug feito de espaços.

Arquivos do exemplo

  • local-response-states.json Auxílio de inspeção com a observação local 201/302 e os corpos JSON desta rota. Não é um link curto ativo.
  • reserved-slugs.txt Auxílio de inspeção com cada slug personalizado que o servidor recusa por estar reservado.

Destinos bloqueados, limites e links desativados

Alguns pedidos nunca viram redirecionamento. Um link desativado deixa de encaminhar visitantes e não os envia para outro lugar.

Casos

Um destino localhost é recusado. Criar mais rápido do que a janela permite é recusado. Um código desconhecido e um código desativado não redirecionam.
Configurações
Limite de criação 10 a cada 60 segundos e 60 por hora
Chave do cliente SHA-256 do IP de conexão ou, se não houver IP, do user agent mais o idioma
Comportamento desativado HTTP 410, erro JSON Short link disabled.

Resultado observado

Verificações locais devolveram 400 invalid_url para localhost, 429 com cabeçalho Retry-After quando o limite foi ultrapassado, 404 para um código ausente e 410 para um código desativado. Nenhum número de exemplo de Retry-After foi registrado.

O que conferir

O destino precisa ser uma URL http ou https pública, com no máximo 2.048 caracteres, sem usuário nem senha. Localhost, loopback e endereços privados são recusados antes do contador de limite. Acima do limite, a API devolve 429 e a página diz que muitos links foram criados por esta conexão. Envie a URL curta completa e o motivo para contact@kitlyapp.com para denunciar um link abusivo. A Kitly pode desativar esse redirecionamento. Desativar não é editar: o visitante passa a receber 410 em vez de um destino substituto.

Ressalvas

  • Os links não expiram sozinhos e não há um painel do dono.
  • Não coloque segredos na URL de destino. Ela é armazenada, e o link curto existe para ser compartilhado.
  • Estes estados não foram enviados para produção.

Arquivos do exemplo

  • local-response-states.json Auxílio de inspeção com a observação local 201/302 e os corpos JSON desta rota. Não é um link curto ativo.

Escolhas que combinam com este encurtador

Use um link curto para uma página pública que você já abriu. O servidor guarda o destino e responde aos pedidos seguintes com um redirecionamento.

Slug vazio ou slug personalizado

Use quando: Deixe o campo vazio para um código automático de 7 caracteres. Informe um slug quando um nome legível ajuda e ele ainda está livre.

Trocas: Um nome personalizado é mais fácil de adivinhar e pode colidir. Palavras reservadas como admin, api e tools devolvem 409. O padrão é 3–64 letras minúsculas, números ou hífens, começando e terminando com letra ou número.

Destino HTTPS público

Use quando: O endereço é http ou https, não traz usuário nem senha embutidos e não é localhost nem um IP privado.

Trocas: Uma URL só com o host é gravada com barra no final. A verificação olha o hostname enviado. Ela não atesta a página e não acompanha mudanças posteriores nesse site.

Diga o destino em palavras

Use quando: A mensagem ao redor do link ainda não mostra onde as pessoas vão chegar.

Trocas: Um código curto esconde o destino. Quem recebe precisa confiar no redirecionamento. Guarde a sua cópia da URL original.

Denuncie um link ruim em vez de editá-lo

Use quando: Um código publicado aponta para algo inseguro ou abusivo, ou você precisa que ele pare de redirecionar.

Trocas: Não há controle de edição, expiração ou exclusão. Desativar um link devolve 410. Isso não faz o código antigo encaminhar para uma URL corrigida. Um QR code desse link curto tem o mesmo limite.

Mensagens que o formulário pode mostrar

O formulário mostra uma frase localizada para o código de erro da API. O arquivo de exemplo traz a mensagem da própria API.

Problema: Informe uma URL pública http ou https.

Causa provável: O endereço está ausente, longo demais, usa outro esquema, inclui usuário ou senha, ou aponta para localhost ou um endereço privado.

O que fazer: Abra primeiro a página https pública e depois cole essa URL. Localhost e IPs privados continuam recusados.

Problema: O slug é curto demais, usa os caracteres errados ou está reservado.

Causa provável: Menos de 3 caracteres, mais de 64, hífen no início ou no fim, um caractere que não seja letra minúscula, número ou hífen, ou uma palavra da lista reservada.

O que fazer: Use de 3 a 64 letras minúsculas, números ou hífens, começando e terminando com letra ou número. Se o nome for reservado, escolha outro. O formulário já coloca o campo em minúsculas.

Problema: Esse slug personalizado já está em uso.

Causa provável: O código existe no armazenamento. Criá-lo de novo devolve 409.

O que fazer: Escolha outro slug ou limpe o campo e deixe o servidor atribuir um código.

Problema: Muitos links foram criados por esta conexão.

Causa provável: Este hash de cliente passou de 10 criações na janela atual de 60 segundos ou de 60 criações na hora atual. A resposta é 429 com Retry-After.

O que fazer: Espere a janela indicada no cabeçalho Retry-After. Tentativas com URL ou slug inválidos são recusadas antes de entrarem na contagem.

Problema: O link curto devolve 404 ou 410.

Causa provável: 404 significa que o código não existe ou que o caminho não tem de 3 a 64 caracteres válidos. 410 significa que a linha existe e está desativada.

O que fazer: Confira se o código foi digitado corretamente. Um link desativado não redireciona. Denuncie abuso, com a URL curta completa, para contact@kitlyapp.com. Não há botão aqui para reativar o seu link ou apontá-lo para outro lugar.

Fontes relevantes

Os códigos de status da Kitly seguem estas definições de HTTP. Os limites exatos são os deste repositório.

Perguntas frequentes

O que faz um encurtador de URL?

Um encurtador de URL guarda um destino na Kitly e o transforma em um link mais curto que redireciona visitantes para essa URL.

Posso usar links curtos em campanhas?

Você pode apontar um link curto para uma landing page pública. A Kitly não oferece analytics de campanha, expiração nem um editor na própria página. Links desativados devolvem 410.

O encurtador de URL precisa de servidor?

Sim. Links curtos precisam de armazenamento e redirecionamento no servidor para que cada código curto leve visitantes ao URL original. As ferramentas de arquivo da Kitly não usam este caminho.

Posso editar, expirar ou apagar um link curto da Kitly?

Não. Não há painel do dono, controle de edição nem expiração automática. Um link desativado devolve HTTP 410 em vez de redirecionar. Para interromper um redirecionamento abusivo, envie a URL curta completa e o motivo para contact@kitlyapp.com.

Por que um slug ou um destino seria recusado?

O slug precisa ter de 3 a 64 letras minúsculas, números ou hífens, começar e terminar com letra ou número, e não pode estar reservado nem em uso. O destino precisa ser uma URL http ou https pública. Localhost, endereços privados, outros esquemas e senhas embutidas são recusados. A criação também fica limitada a 10 por minuto e 60 por hora para um cliente.

Continue com uma ferramenta publicada ou uma sequência testada neste idioma.