API QR

View as Markdown

API QR

Creá QRs con link corto /r/{code}, pausalos, eliminálos y consultá escaneos.

Endpoints

MétodoRutaScope
POST/qrqr:write
GET/qrqr:read
GET/qr/{id}qr:read
PATCH/qr/{id}qr:write
DELETE/qr/{id}qr:write
GET/qr/{id}/statsqr:read

Activar seguimiento

El body incluye tracking: true (equivale al switch del generador web). Este endpoint siempre crea un QR trackeado. Si mandás tracking: false, recibís 400.

Mismas opciones que el front

POST /qr acepta el mismo set de opciones que el studio:

  • Contenido: url, wifi, vcard, whatsapp, text, email
  • Diseño: colores, gradiente, esquinas, logo, marco, ECC, resolución
  • Campos tipados (url, wifiSsid, …) o payload crudo

El diseño se guarda en design y el QR encodea el link corto; el destino real queda en payload.

Preview visual

Para ver el QR mientras editás el JSON del request:

Playground QR

Pausar

$curl -X PATCH https://www.herramientas.lat/api/v1/qr/{id} \
> -H "Authorization: Bearer hl_..." \
> -H "Content-Type: application/json" \
> -d '{"active": false}'

Con active: false, /r/{code} responde 404.