Ler um Código QR a partir de uma imagem
- Painel
- Documentação
- API
Porquê utilizar uma ferramenta de leitura de QR codes?
Os QR codes estão por todo o lado: cartazes, etiquetas, faturas, cartões de visita, menus de restaurante. Codificam URL, contactos, identificadores de wifi ou simples cadeias de texto. Esta ferramenta permite-lhe descodificar o conteúdo de um QR code a partir de uma imagem, sem ter de usar o smartphone.
Características da ferramenta de leitura de QR codes
A ferramenta aceita uma imagem em formato JPEG, PNG, GIF, WebP ou BMP, com tamanho máximo de 10 MB. Analisa o QR code detetado na imagem e devolve o seu conteúdo textual. Nenhuma imagem é conservada no servidor depois do tratamento.
Como utilizar a ferramenta de leitura de QR codes
Selecione uma imagem que contenha um QR code legível, depois clique no botão "Descodificar". O conteúdo descodificado é apresentado na área de resultado, pronto a copiar.
Conselhos para uma boa descodificação
Para maximizar as hipóteses de deteção, use uma imagem nítida e bem contrastada, recortada à volta do QR code. Evite imagens demasiado escuras, desfocadas ou deformadas. Se a imagem vem de uma fotografia, endireite-a antes de a enviar.
Perguntas frequentes
Que formatos de imagem posso carregar?
A ferramenta aceita JPEG, PNG, GIF, WebP e BMP, no limite de 10 MB por ficheiro. Se o seu QR code estiver num PDF, exporte-o primeiro para imagem (captura de ecrã, exportação de imagem no Pré-visualização do macOS ou clique direito numa página no Acrobat). O descodificador não lê diretamente ficheiros PDF.
A descodificação funciona com uma fotografia tirada com o smartphone?
Sim, desde que a fotografia esteja nítida e bem iluminada. Se o QR estiver ligeiramente inclinado, a descodificação continua possível: a especificação permite alguma tolerância graças aos marcadores de posição nos cantos. Para casos difíceis, recorte a imagem em volta do QR antes de a enviar, para eliminar distrações visuais.
A imagem carregada é conservada?
Não. A imagem é processada durante o tempo do pedido e depois apagada. O conteúdo textual descodificado é devolvido na resposta mas não armazenado no servidor. Nenhum serviço de terceiros é chamado para a análise, tudo acontece na nossa infraestrutura.
Porque é que a ferramenta não deteta nenhum QR na minha imagem?
Várias causas possíveis: imagem demasiado pequena ou demasiado escura, QR parcialmente tapado, perspetiva demasiado acentuada ou contraste insuficiente. Tente outra vez com uma imagem recortada e endireitada. Se o QR tem um logótipo central demasiado volumoso, a sua correção de erros pode ter sido saturada na geração, o que impede qualquer releitura.
Funciona com Datamatrix ou códigos de barras clássicos?
Não, esta ferramenta limita-se aos QR codes no sentido estrito (norma ISO/IEC 18004). Datamatrix, EAN, Code 128 ou Aztec utilizam outros formatos de leitura. Para estes padrões, é necessário um leitor dedicado; ainda não oferecemos uma ferramenta correspondente.
Como gerar um QR code a partir de um texto ou de um URL?
Utilize o nosso gerador de QR code: introduza o seu texto ou o seu URL, escolha a saída PNG ou SVG, e recupere a imagem pronta a imprimir ou a integrar numa página web. O SVG é recomendado para impressão em grande formato.
Exemplo de pedido
curl -X POST https://cdrn.fr/api/v1/tools/qr-code-reader/execute \
-F "image=@/path/to/file"Esquema de entrada
| Campo | Tipo | Obrigatório | Predefinição |
|---|---|---|---|
image |
file | – |
esta ferramenta espera um ficheiro - utilize Content-Type multipart/form-data em vez de application/json
Pontos de acesso
GET https://cdrn.fr/api/v1/tools- lista todas as ferramentas disponíveisGET https://cdrn.fr/api/v1/tools/qr-code-reader- obtém o esquema desta ferramentaPOST https://cdrn.fr/api/v1/tools/qr-code-reader/execute- executa esta ferramenta com um payload JSON