QRCODE

Gerador de QR Code

Manda qualquer texto ou URL, recebe um PNG de volta. Sem cadastro de conta pra cada código, sem SDK — é uma chamada GET que devolve a imagem pronta.

QR code generator

Send any text or URL, get a PNG back. No per-code account setup, no SDK — it's a GET call that returns the finished image.

SYNC resposta na mesma chamada answers in the same call

Endpoint

GET /api/v1/qrcode gera um QR code generates a QR code

A resposta de sucesso é a imagem crua (Content-Type: image/png), não o envelope JSON que o resto da API usa — é um PNG, não dado estruturado. Erros continuam vindo como JSON normalmente.

The success response is the raw image (Content-Type: image/png), not the JSON envelope the rest of the API uses — it's a PNG, not structured data. Errors still come back as JSON as usual.

Parâmetros

Parameters

Nome	Name	Onde	In	Descrição	Description
`data`	query	obrigatório — o texto ou URL a codificar, até 2000 caracteres	required — the text or URL to encode, up to 2000 characters
`size`	query	opcional, padrão `256` — lado da imagem em pixels, entre `64` e `1024`	optional, defaults to `256` — image side in pixels, between `64` and `1024`

Exemplo

Example

curl "https://api.alicercelabs.com.br/api/v1/qrcode?data=https://alicercelabs.com.br&size=256" \
  -H "Authorization: Bearer <token>" \
  -o qrcode.png

O arquivo salvo é um PNG de verdade, pronto pra abrir ou embutir num <img src> — não tem passo de decodificação, o corpo da resposta já é a imagem.

The saved file is a real PNG, ready to open or embed in an <img src> — no decoding step, the response body already is the image.

Erros possíveis

Possible errors

Status	Motivo	Reason
400	`data` ausente/maior que 2000 caracteres, ou `size` fora do intervalo 64-1024	missing/too-long `data`, or `size` outside the 64-1024 range
401	token ausente ou inválido	missing or invalid token
429	limite de taxa excedido	rate limit exceeded

Limites

Limits

10.000/dia · 416/hora, por IP chamador. O mesmo data+size sempre gera o mesmo PNG, então o resultado fica em cache por 24h — chamadas repetidas com o mesmo par não recalculam nada.

10,000/day · 416/hour, per calling IP. The same data+size always produces the same PNG, so the result is cached for 24h — repeated calls with the same pair don't recompute anything.