El código QR para tus facturas, en una llamada.

Generar un código

Un POST con el contenido en el cuerpo. El contenido nunca va en la dirección, para que no quede en los registros de los servidores por el camino.

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
}'

Cuerpo de la petición

Respuesta

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

Los mismos números vienen en las cabeceras X-QrSensei-Remaining, X-QrSensei-Limit y X-QrSensei-Reset.

Autenticación

Cada llamada lleva la clave de tu aplicación en la cabecera Authorization: Bearer qs_live_….

• La clave se muestra una vez, al crearla. Solo guardamos una huella: si la pierdes, crea una nueva en tu perfil y la antigua deja de funcionar.
• Llama desde tu servidor, nunca desde un navegador o una app: una clave en el código del front-end la puede leer cualquiera.
• No se guarda nada de los códigos: ni el contenido ni las imágenes. Solo un recuento por mes.

Contenidos

Los mismos tipos que el editor, con las mismas reglas. Esta tabla se lee de las reglas que comprueban cada llamada: no puede quedarse desactualizada.

Una Wi-Fi sin contraseña lleva encryption "nopass". Un campo omitido queda vacío; un campo obligatorio que falta se nombra en el detail del error.

Estilos

Diseñados en tu perfil, con el código en vivo al lado. Cada uno tiene un id y uno es tu predeterminado; o escribe el estilo en la propia llamada, 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" } }

Un estilo solo se acepta si se lee: formas que combinan, y tinta más oscura que el papel con un contraste de al menos 4,5:1. Un código transparente se comprueba contra blanco, el papel de una factura.

Marcas

"auto" reconoce la marca por el enlace (un enlace de Instagram lleva el logotipo de Instagram). Un nombre fija la marca; "none" deja el centro libre. La lista también viene de GET /v1/brands.

Contra el phishing: en un enlace, una marca fija solo se usa si el enlace es de esa marca. El logotipo de un banco nunca acaba en un enlace 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

Límites

Errores

Siempre un objeto error con code, message y, cuando ayuda, detail: el code es para tu programa, el message para quien lo lea. Una llamada con error no se cuenta.