Lição 3
Codificando URLs, Wi-Fi e texto
Formatos de payload que escaneiam de forma confiável.
O símbolo QR é genérico; o formato do payload define o que acontece após um scan bem-sucedido.
URLs
Boas práticas:
- Inclua o esquema:
https://(não sóexample.com, a menos que queira uma busca) - Evite ruído desnecessário na query; codifique caracteres especiais corretamente antes
- Teste URLs de staging vs produção antes de imprimir milhares de etiquetas
Se uma URL tiver caracteres reservados, corrija a codificação com uma ferramenta de URL antes de gerar o payload do QR — não depois.
Texto simples
QR codes de texto copiam ou exibem uma mensagem. Não abrem apps magicamente, a menos que o app do scanner escolha uma ação.
Bom para:
- Códigos curtos de suporte
- Etiquetas internas de ativos
- Instruções offline
Mantenha o texto curto quando também precisar de alta correção de erros ou impressão pequena.
Strings Wi-Fi
Muitas plataformas reconhecem o schema WIFI::
WIFI:T:WPA;S:MyNetwork;P:secret-password;;
Campos:
T— tipo de segurança (WPA,WEP,nopass)S— SSIDP— senha
Caracteres especiais em SSID ou senha podem precisar de escape conforme a spec. Sempre escaneie em um celular real no SO alvo antes de publicar cartazes de Wi-Fi para visitantes.
Erros comuns
- Codificar URL de redirect que muda depois
- Colar HTML ou markdown em vez da URL bruta
- Senha Wi-Fi com
;ou\sem escape quebrando o parser
Resumo
Codifique a string exata que você quer que o scanner entregue. Valide URLs e strings Wi-Fi no editor de texto e gere o QR localmente.