Gerar QR Code

Gera um QR Code e retorna a imagem em uma resposta JSON. Use HTTP POST com Content-Type: application/json.

Escolha uma origem

Envie exatamente um destes campos:

• link_id: ID de um link criado por quem gerou o token. O QR Code contém a URL curta desse link.
• perfil: true: usa o endereço do Link na Bio de quem gerou o token. O perfil precisa estar salvo.
• conteudo: texto ou endereço de até 1.200 bytes. Acentos e emojis podem ocupar mais de um byte por caractere.

Com token da empresa, link_id e perfil também se limitam a quem gerou o token. Para outro link da empresa, consulte sua url_curta em Obter link e envie esse endereço em conteudo.

Formato, tamanho e cores

Escolha png para uma imagem de tamanho definido ou svg para impressão e redimensionamento sem perda de definição. O padrão é PNG.

tamanho aceita 256, 512, 1024 ou 2048 pixels, com padrão 1024. cor define o desenho e fundo define o fundo, ambos em #RRGGBB. Os padrões são #000000 e #ffffff.

Um conteúdo extenso pode exigir uma imagem maior. Se a API pedir um tamanho maior, aumente tamanho e tente novamente. Use cores com bom contraste e teste a leitura antes de imprimir.

Imagem retornada

Campo	Descrição
formato	Formato gerado: png ou svg.
mime	Tipo da imagem: image/png ou image/svg+xml.
tamanho	Lado da imagem, em pixels.
imagem_base64	Conteúdo do arquivo codificado em base64, sem prefixo de URL de dados.

Decodifique dados.imagem_base64 para obter o arquivo. O guia Salvar a imagem de um QR Code mostra como gravá-lo e exibi-lo.

Validação da requisição

Uma origem ausente ou duplicada, um campo desconhecido ou uma opção inválida retorna HTTP 400. Um link não acessível por link_id ou um Link na Bio ainda não salvo retorna 404.

Esta operação gera a imagem sem criar um link ou salvar um QR Code na biblioteca do painel.