DOSSIÊ DE ROTEAMENTO DE LINK CURTO / LIVRO DE REDIRECIONAMENTO
Registe um destino web público atrás de uma rota /s curta
Envie um URL HTTP ou HTTPS ao editor. O servidor aplica assertPublicHttpUrl, exclui destinos locais e privados e guarda o destino normalizado se a criação for bem-sucedida. Um destino com aspeto público não afirma que todo destino público é aceite, responde ou se mantém igual depois.
- Entrada de destino HTTP ou HTTPS
- Saída: file-tools24.com/s/:shortCode
- 301 êxito · 404 ausente, expirado ou rejeitado
Dossiê de roteamento de link curto
01 · ENVIO DO DESTINO
URL HTTP ou HTTPS → assertPublicHttpUrl → valor normalizado guardado após criação bem-sucedida.
02 · ENTRADA DE CÓDIGO
Código aleatório ou alias aceite torna-se o registo de código curto.
03 · PERCURSO DE RESOLUÇÃO
GET /s/:shortCode → getOriginalUrl → 301 para o destino guardado quando é devolvido.
O destino guardado é verificado novamente na resolução. Um registo rejeitado, ausente ou expirado devolve 404; uma exceção devolve 500.
Do destino enviado à resposta de redirecionamento
Este dossiê descreve o percurso implementado de armazenamento e resolução. Não descreve conteúdo do destino, qualquer cadeia de redirecionamento nem se um destino responderá.
1. Verificar e normalizar o destino
A criação aceita apenas um URL HTTP ou HTTPS. assertPublicHttpUrl exclui destinos de rede locais e privados; em seguida a cadeia URL normalizada é guardada. Essa verificação é um limite, não uma afirmação sobre qualquer destino público.
2. Escrever um registo de código curto
Sem alias, o serviço começa com seis caracteres alfanuméricos e verifica colisões até dez tentativas; nesse limite gera um código de oito caracteres. O procedimento não é uma afirmação absoluta de unicidade.
3. Resolver a rota /s
GET /s/:shortCode chama getOriginalUrl. Verifica a expiração e chama assertPublicHttpUrl novamente sobre o destino guardado. Um destino devolvido recebe 301; registos ausentes, expirados ou rejeitados recebem 404, salvo exceção com 500.
Gramática de código e entrada de expiração
Os campos opcionais são guardados com o registo de link curto. Não criam uma interface de edição ou gestão de prazo.
ALEATÓRIO — Seis, depois oito no limite de pesquisa
O código gerado inicial tem seis letras ou dígitos. A verificação de colisões pode fazer dez tentativas; o percurso de limite cria oito caracteres.
ALIAS — 3–50 letras, números ou hífenes
Um alias deve seguir essa gramática. Um código já presente é rejeitado em vez de ser reatribuído.
EXPIRAÇÃO — Data opcional guardada
Uma expiração opcional é guardada. Quando a hora está no passado, getOriginalUrl devolve null e o endpoint /s responde 404.
O estado de resolução é um resultado de roteamento restrito
O endpoint tem apenas o percurso de resposta seguinte. Não afirma conteúdo do destino, cadeias de redirecionamento ou resposta de um destino.
301 — Destino devolvido
Quando getOriginalUrl devolve o destino guardado após as verificações, GET /s/:shortCode envia um redirecionamento 301 para esse URL.
404 — Sem registo resolúvel
Um código ausente, um registo expirado ou um destino guardado rejeitado durante a verificação renovada produz 404.
500 — Percurso de exceção
Se a rota encontrar uma exceção, envia 500. É distinto do percurso de resultado 404.
Contador guardado e limite de propriedade
O registo guardado contém um campo clicks e, quando a criação tem contexto autenticado, uma userId. São comportamentos restritos do registo.
CLICKS +1 — Um incremento após redirecionamento bem-sucedido
Cada redirecionamento bem-sucedido incrementa o campo clicks guardado em um.
UM CONTADOR — Não é relatório de visitantes ou campanhas
O campo clicks é apenas um contador guardado; não decorre qualquer conclusão adicional.
PROPRIETÁRIO — A gestão liga-se à propriedade autenticada
A criação é pública. Com contexto autenticado, userId é guardada; list devolve apenas links desse utilizador e delete exige a mesma userId. Sem esse contexto, a criação funciona, mas list não devolve links próprios geríveis.
Saída do navegador após a criação
Após uma criação bem-sucedida, o navegador gera um URL de dados QR para o URL curto devolvido com 300px e margem 2. O editor também oferece cópia e transferência PNG. A saída QR representa esse percurso devolvido, sem afirmação de leitura ou persistência.
Notas de âmbito para este registo de roteamento
- Apenas entrada de destino HTTP e HTTPS chega à verificação do servidor.
- Um destino com aspeto público pode ser rejeitado, não responder ou mudar depois.
- Não é feita afirmação sobre conteúdo de destino ou percursos de redirecionamento posteriores.
- A geração de código, o alias e o registo de expiração têm comportamento limitado.
Continuar com ferramentas webmaster próximas
Cada ferramenta relacionada tem o seu próprio percurso de entrada e resultado.
- Gerador de código QR
Crie uma representação QR para dados introduzidos compatíveis e reveja a imagem devolvida.
- Consulta DNS
Leia registos DNS devolvidos pelo percurso de resolvedor configurado.
- Verificador SSL
Registe campos de certificado de um percurso HTTPS de handshake limitado.
Perguntas sobre roteamento de link curto
O serviço aceita todo URL público?
Não. Criação e resolução chamam assertPublicHttpUrl e excluem destinos locais e privados. Passar ou parecer público não estabelece que todo destino público é aceite, responde ou se mantém igual.
Que forma tem um URL curto devolvido?
O resultado da criação usa exatamente https://file-tools24.com/s/:shortCode, com o código do registo no lugar de :shortCode.
O que acontece depois de uma expiração?
A expiração é guardada com o registo. Quando está no passado, getOriginalUrl devolve null e GET /s/:shortCode responde 404.
Quem pode listar ou eliminar um link criado?
A criação pública pode ocorrer sem contexto autenticado. Só um contexto autenticado recebe os seus links por list, e a eliminação limita-se a um registo com a mesma userId guardada.