O QR code para as suas faturas, num pedido.

Gerar um código

Um POST com o conteúdo no corpo. O conteúdo nunca vai no endereço, para não ficar nos logs dos servidores pelo caminho.

curl https://api.qrsensei.com/v1/qr \
  -H "Authorization: Bearer $QRSENSEI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "content": {
    "type": "text",
    "text": "FT 2026/118 · 149,90 EUR"
  },
  "brand": "qrsensei",
  "style": {
    "color": {
      "kind": "solid",
      "color": "#18181B"
    }
  },
  "format": "png",
  "size": 256
}'

Corpo do pedido

Resposta

{
  "image": "data:image/png;base64,iVBORw0KGgo…",
  "format": "png",
  "remaining": 902,
  "limit": 1000,
  "resetsAt": "2026-12-01T00:00:00.000Z"
}

Os mesmos números vêm nos cabeçalhos X-QrSensei-Remaining, X-QrSensei-Limit e X-QrSensei-Reset.

Autenticação

Cada chamada leva a chave do seu aplicativo no cabeçalho Authorization: Bearer qs_live_….

• A chave aparece uma única vez, quando é criada. Guardamos só uma impressão digital dela: se perder, crie uma nova no seu perfil e a antiga deixa de funcionar.
• Chame a partir do seu servidor, nunca do navegador ou de um app: uma chave no código do front-end pode ser lida por qualquer pessoa.
• Nada dos códigos fica guardado: nem o conteúdo nem as imagens. Só uma contagem por mês.

Conteúdos

Os mesmos tipos do editor, com as mesmas regras. Esta tabela é lida das regras que verificam cada chamada: não tem como ficar desatualizada.

Um Wi-Fi sem senha leva encryption "nopass". Um campo omitido fica vazio; um campo obrigatório em falta é nomeado no detail do erro.

Estilos

Desenhados no seu perfil, com o código ao vivo ao lado. Cada um tem um id e um deles é o seu padrão; ou escreva o estilo na própria chamada, como style.

{}

{ "color": { "kind": "solid", "color": "#18181B" }, "background": { "kind": "transparent" }, "quietZone": 2 }

{ "dots": "dots", "finders": "drop", "color": { "kind": "gradient", "type": "linear", "angle": 45, "stops": [ "#0F172A", "#1E40AF" ] }, "background": { "kind": "solid", "color": "#FFF7ED" } }

Um estilo só é aceito se for legível: formas que combinam, e tinta mais escura que o papel, com contraste de pelo menos 4,5:1. Um código transparente é verificado contra branco, o papel de uma fatura.

Marcas

"auto" reconhece a marca pelo link (um link do Instagram leva o logotipo do Instagram). Um nome fixa a marca; "none" deixa o centro livre. A lista também vem de GET /v1/brands.

Contra phishing: num link, uma marca fixa só é usada se o link for dessa marca. O logotipo de um banco nunca vai parar num link falso.

• qrsensei
• instagram
• facebook
• linkedin
• x
• tiktok
• youtube
• github
• spotify
• whatsapp
• telegram
• signal
• viber
• snapchat
• pinterest
• threads
• discord
• reddit
• messenger
• googleMaps
• appleMaps
• waze
• paypal
• revolut
• wise
• stripe

Limites

Erros

Sempre um objeto error com code, message e, quando ajuda, detail: o code é para o seu programa, a message para quem lê. Uma chamada com erro não é contada.