ForHosting KIT · Ferramentas para dev

Crie uma string QR WiFi para redes WPA, WEP ou abertas

Uma carga QR WiFi é o texto codificado em um QR code que permite ao celular reconhecer credenciais de rede sem exigir digitação.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

Esta ferramenta monta a carga padrão a partir do SSID, da senha e do tipo de criptografia que você selecionar. Ela aceita WPA, WEP e redes abertas, escapa caracteres especiais do formato e devolve texto pronto para qualquer gerador de QR. O resultado é determinístico, fácil de conferir e está disponível pela API por US$ 0,002 por solicitação.

Informe os dados de rede necessários aos dispositivos

Comece pelo SSID exatamente como ele aparece no ponto de acesso sem fio. Nomes de rede diferenciam maiúsculas de minúsculas; portanto, letras, espaços e pontuação precisam coincidir com o que os usuários veem. Em seguida, informe a senha e selecione WPA, WEP ou none como criptografia. WPA é a escolha adequada para configurações pessoais comuns WPA, WPA2 e WPA3 representadas por esta convenção de texto QR amplamente aceita. WEP permanece disponível para equipamentos antigos, enquanto none indica uma rede sem senha. O gerador aceita as opções sem diferenciar maiúsculas de minúsculas, mas rejeita qualquer valor fora dessas três alternativas para evitar que um erro de digitação crie uma carga enganosa. WPA e WEP exigem senha não vazia. Em uma rede aberta, a senha é ignorada e nenhum campo de senha é emitido. Assim, a saída contém apenas as credenciais realmente necessárias e não incorpora acidentalmente uma senha sem uso.

Entenda a carga e as regras de escape

O valor retornado começa com WIFI: e contém campos identificados, separados por ponto e vírgula. O campo T indica a autenticação, S contém o SSID e redes criptografadas também recebem um campo P com a senha. Dois pontos e vírgulas encerram a carga. Redes abertas usam o valor convencional nopass e omitem P. Alguns caracteres comuns têm função estrutural: uma barra invertida inicia um escape, um ponto e vírgula encerra um campo, e vírgulas ou dois-pontos podem ser tratados como delimitadores por analisadores compatíveis. O gerador coloca uma barra invertida antes de cada um desses caracteres quando eles aparecem no SSID ou na senha. Esse cuidado é essencial para nomes como Office:Guest e senhas com pontuação, pois concatenar valores brutos pode gerar uma string aparentemente correta que o leitor separa nos campos errados. A ferramenta retorna a carga como texto JSON; ela não desenha pixels nem altera as credenciais.

Codifique, teste e compartilhe o resultado com segurança

Envie a carga retornada, sem modificações, para uma biblioteca de QR code, um serviço de impressão, um fluxo de etiquetas ou um aplicativo de design que aceite texto livre. Escolha correção de erros e tamanho físico adequados ao ambiente e teste o símbolo final em mais de um dispositivo antes da distribuição. Uma carga válida não garante que o celular alcance o ponto de acesso, que a senha esteja atualizada ou que todo sistema operacional aceite cada criptografia antiga. Trate a string como sensível sempre que ela incluir uma senha: não a coloque em logs públicos, eventos de análise, repositórios de código ou chamados de suporte, e descarte códigos impressos quando as credenciais mudarem. Esta capacidade não consulta nem verifica a rede sem fio. Sua função é objetiva: validar a criptografia, escapar texto significativo para o formato e montar uma carga reutilizável. Essa separação permite mudar a renderização QR sem afetar uma serialização estável e fácil de testar.

Prepare um cartão para visitantes

Crie o texto de credenciais para um QR impresso na recepção, permitindo o acesso sem digitar uma senha longa.

Automatize etiquetas de configuração

Gere cargas consistentes de SSIDs e senhas provisionados antes que outro serviço produza as etiquetas dos dispositivos.

Trate pontuação com segurança

Monte uma carga válida quando o nome ou a senha contiver ponto e vírgula, dois-pontos, vírgula ou barra invertida.

Quanto custa uma solicitação?

Cada solicitação de API custa US$ 0,002.

A ferramenta cria uma imagem QR?

Não. Ela retorna a string WiFi padrão que você pode enviar a um gerador de QR code.

Quais criptografias são aceitas?

WPA, WEP e none são aceitas. Qualquer outro valor gera um erro de entrada inválida.

O que ocorre com a senha de uma rede aberta?

Ela é ignorada, e a carga nopass gerada não contém um campo de senha.

Os caracteres especiais recebem escape?

Sim. Barras invertidas, pontos e vírgulas, vírgulas e dois-pontos no SSID ou na senha recebem uma barra invertida inicial.

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

POSThttps://api.kit.forhosting.com/enc/qr-wifi-payload

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/enc/qr-wifi-payload \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ssid":"Studio WiFi","password":"correct horse battery staple","encryption":"WPA"}'
{
  "ssid": "Studio WiFi",
  "password": "correct horse battery staple",
  "encryption": "WPA"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.qr_wifi_payload",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →