Gerar slug de URL curta

Encurtadores de URL precisam de códigos de caminho curtos e opacos que apontem para um destino longo sem vazar a estrutura do link. Equipes que constroem o próprio encurtador—ou reservam códigos vanity offline antes da gravação—precisam de uma função determinística: a mesma URL de destino e a mesma semente de inquilino devem sempre produzir o mesmo slug do comprimento escolhido, para que retentativas e escritores multi-região nunca inventem cadeias aleatórias em colisão para o mesmo vínculo lógico. Esta capacidade aceita uma URL alvo, uma semente (namespace, segredo ou chave de inquilino) e um comprimento opcional (padrão sete, mínimo quatro), e expande uma mistura pura no estilo FNV de URL mais semente em dígitos base62 de 0-9, A-Z e a-z.

Como o slug base62 do encurtador com semente é construído

Um slug de encurtador não é um slug de título legível por humanos. É um token opaco em um alfabeto compacto que cabe em códigos QR, SMS e embalagens impressas e ainda oferece espaço combinatório suficiente para milhões de links. Esta ferramenta usa o alfabeto clássico base62 de dez dígitos, vinte e seis letras maiúsculas e vinte e seis minúsculas—sessenta e dois símbolos que transitam com segurança em segmentos de caminho sem percent-encoding.

O gerador concatena a URL de destino, um separador NUL e a semente, e executa rodadas FNV-1a de 32 bits com contador que expandem cinco dígitos base62 por rodada até preencher o comprimento pedido. Como a mistura é aritmética pura sobre códigos de caractere, as mesmas entradas sempre geram o mesmo slug no Node e no navegador.

A semente é o que torna seguros os sistemas multi-inquilino: dois inquilinos que encurtam a mesma URL de marketing com sementes diferentes obtêm códigos diferentes, de modo que namespaces públicos compartilhados não revelam que duas organizações apontaram para o mesmo destino. O comprimento padrão é sete caracteres (cerca de 3.5e12 possibilidades) e pode ir de quatro a trinta e dois; quatro é o piso rígido porque espaços de três caracteres são pequenos demais para encurtadores abertos na internet e convidam enumeração por força bruta do espaço de caminhos.

Onde um gerador de slug de URL curta com semente agrega valor

Backends de encurtador auto-hospedados usam esta capacidade para pré-calcular códigos em workers antes de um insert transacional, mantendo a lógica de alocação idêntica em cada região sem compartilhar uma sequência aleatória central. Equipes de operações de marketing geram códigos de campanha estáveis offline a partir de uma URL de landing conhecida e uma semente de campanha, para que revisão criativa, arte QR e o corte para produção compartilhem uma única string.

Produtos SaaS multi-inquilino passam o id do inquilino como seed para que o cliente A e o cliente B nunca recebam o mesmo caminho público para destinos idênticos, o que simplifica a revisão de abuso e as narrativas de residência de dados. Prefira comprimentos maiores quando o namespace for público e de longa duração; use o mínimo quatro só em sistemas fechados com tratamento agressivo de colisões.