logo
Links•

Personalize a chave do seu link curto

Escolha o final do seu link curto na CodeQR — caracteres aceitos, limites por plano, o que quebra ao trocar a chave e os erros mais comuns.

Avatar for undefined
CodeQR Team
Equipe de Conteúdo

A chave é tudo o que vem depois do domínio — o cardapio-verao em go.example.com/cardapio-verao. Uma chave legível é clicada e digitada corretamente; uma aleatória serve quando ninguém precisa memorizar. Esta página mostra o que dá para digitar, quais são os limites e qual é a mudança que quebra links já espalhados.

Disponibilidade

  • Plano: todos. Chaves de até três caracteres e uma lista curta de chaves premium exigem Starter ou superior.
  • Onde: o campo Link Curto no construtor de links, ao lado do seletor de domínio.

Antes de começar

  • A chave é única por domínio. go.example.com/promo e links.example.com/promo são dois links diferentes.
  • Deixando o campo em Opcional, a CodeQR gera uma chave aleatória de sete caracteres.

Passos

  1. Abra o construtor e preencha URL de destino primeiro.
  2. Digite a chave em Link Curto. Espaços viram - enquanto você digita.
  3. Confira o campo mais uma vez antes de salvar — veja o primeiro item da solução de problemas.
  4. Clique em Criar link.

URL de destino, Link Curto, Pasta e Usar como modelo no construtor de links da CodeQR

O que dá para digitar

  • Letras, números, - e /. Letras acentuadas e de outros alfabetos são aceitas e guardadas numa forma segura para a web.
  • A / cria um caminho. catalogo/2026 vira go.example.com/catalogo/2026, o que ajuda a organizar material impresso.
  • Maiúsculas são preservadas, mas ignoradas na hora de abrir. Um link salvo como Cardapio-Verao também abre por cardapio-verao, então ninguém perde a visita por causa de uma letra maiúscula. Os relatórios mostram a chave como você salvou.
  • Tamanho: de quatro caracteres para cima em qualquer plano; uma, duas ou três letras exigem Starter ou superior, porque chaves curtas são escassas.
  • Não vale: espaços e pontuação além de - e /, nem finais com -qr, reservados para QR codes.

Os dois ícones acima do campo montam a chave para você: um sorteia uma sequência aleatória, o outro sugere uma a partir da sua página de destino, com IA.

Trocar a chave depois

Você pode renomear a chave quando quiser, e a CodeQR pede confirmação porque o endereço antigo para de funcionar na hora: Editar um link curto existente pode potencialmente quebrar links existentes. Tem certeza de que deseja continuar?

Tudo que já foi compartilhado aponta para a chave antiga — mensagens, material impresso, publicações de outras pessoas e qualquer QR code gerado a partir do endereço antigo. Se o link já está na rua, troque a URL de destino e deixe a chave quieta. É exatamente para isso que serve um link curto: o endereço fica, o destino muda.

Faça o mesmo pela API

Envie key junto com o destino:

curl -X POST https://api.codeqr.io/links \
  -H "Authorization: Bearer codeqr_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/cardapio","domain":"go.example.com","key":"cardapio-verao"}'

Sem key, a API devolve uma aleatória. Para guardar o seu próprio identificador ao lado dela — número de pedido, id de uma linha de planilha — envie externalId e leia o link depois com GET /links/info?externalId=ext_<seu-id>.

Verifique se funcionou

curl -sSI https://go.example.com/cardapio-verao
HTTP/2 302
location: https://example.com/cardapio

Uma linha location apontando para o seu destino significa que a chave está no ar. Teste uma vez em maiúsculas para ver que ela resolve do mesmo jeito.

Solução de problemas

A chave que digitei virou letras aleatórias

A CodeQR pede uma chave aleatória ao servidor assim que você informa o destino. Se você digitar a sua no segundo em que essa resposta está chegando, ela é sobrescrita. Redigite e confira o campo antes de clicar em Criar link.

Duplicate key: this short link already exists.

Aquela chave já está em uso naquele domínio. Acrescente uma palavra, use um caminho (verao/cardapio) ou troque de domínio. Excluir o link antigo libera a chave.

Invalid key.

Há um caractere que a CodeQR não guarda — quase sempre um espaço vindo de um documento, ou pontuação como ?, #, & e %. Fique em letras, números, - e /.

The key cannot end with '-qr'.

Esse sufixo é reservado. Renomeie a chave ou crie um QR code a partir do link.

You can only use keys of 3 characters or less on a Starter plan.

Chaves muito curtas são um recurso do Starter. Use quatro caracteres ou mais, ou faça upgrade.

This is a premium key.

Um conjunto pequeno de palavras muito disputadas fica reservado a workspaces pagos. Escolha outra chave ou assine o Starter.

Artigos relacionados