API de códigos QR para desarrolladores
El acceso a la API se incluye en los planes Business y Agency.
Endpoints CRUD de códigos QR
Liste y cree códigos QR en /api/v1/qrcodes; consulte, actualice y elimine uno concreto en /api/v1/qrcodes/:id. Un cambio de destination_url o de status mediante PATCH se aplica en el siguiente escaneo: el código impreso no cambia nunca.
Claves API con permisos acotados
Genere claves API desde el panel solo con los permisos que necesitan: qrcodes:read, qrcodes:write, scans:read, conversions:write. Cada clave tiene un límite de 300 peticiones por minuto en la API REST, más un límite independiente de 300 por minuto en las conversiones, y está vinculada a un único espacio de trabajo; guárdela en el servidor.
Datos de escaneo a través de la API
Consulte de forma paginada los eventos de escaneo en /api/v1/scans, filtrados por qr_id y por un número de días: dispositivo, país, procedencia y fecha y hora. Son los mismos datos respetuosos con la privacidad que muestran los gráficos del panel, sin IP en bruto en ningún sitio.
API de conversiones
Envíe con POST eventos de compra y de registro a /api/v1/conversions con un event_name, un external_id para evitar duplicados, un importe y una moneda opcionales, y el qr_slug que trajo al cliente, para atribuir los ingresos al escaneo.
Webhooks
Suscriba endpoints a qr.scanned (cada escaneo real, sin bots) y qr.lead_captured (cada lead de un formulario alojado). Los envíos van firmados con HMAC y se reintentan con espera progresiva.
Píxel JavaScript
Un píxel ligero (/pixel.js) envía las conversiones de su sitio a /api/collect y las vincula con el escaneo QR que trajo al visitante mediante una referencia de atribución propia (el parámetro qr_ref del enlace de destino, guardado en el localStorage de su sitio). Sin huella digital del dispositivo; con Do Not Track activado, envía la conversión sin ninguna propiedad personalizada; y respeta el modelo de privacidad de la plataforma, que no guarda IP en bruto.
Los endpoints en la práctica
Peticiones JSON de entrada y salida, autenticadas con clave API Bearer.
curl -X POST https://qrcode-suite.com/api/v1/qrcodes \
-H "Authorization: Bearer $QRCS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "dynamic_url",
"name": "Spring packaging insert",
"destination_url": "https://example.com/spring-landing"
}'# Re-point a printed code — no reprint needed
curl -X PATCH https://qrcode-suite.com/api/v1/qrcodes/$QR_ID \
-H "Authorization: Bearer $QRCS_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "destination_url": "https://example.com/summer-landing" }'curl -X POST https://qrcode-suite.com/api/v1/conversions \
-H "Authorization: Bearer $QRCS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"event_name": "purchase",
"external_id": "order-1042",
"amount": 49.90,
"currency": "EUR",
"qr_slug": "k7Qm2x"
}'Genere la imagen en PNG o SVG
GET /api/qr/:slug devuelve la imagen escaneable de un código que usted ha creado: ?format=png o ?format=svg, y ?size= en píxeles (400 por defecto). Para imprenta, ?dpi= (150, 300, 600 o 1200) junto con ?mm= produce un archivo con ese ancho físico en milímetros, con la densidad escrita en el PNG para que el software de maquetación lo coloque a su tamaño real. La extensión del archivo corresponde a lo que realmente se generó: un diseño que el rasterizado no puede aplanar se entrega como SVG y así se indica. El endpoint no requiere clave API —la imagen no revela nada más que el slug ya impreso en el código— y tiene límite de peticiones por IP con hash. Solo genera códigos que existen en un espacio de trabajo; no es un generador anónimo.
# Screen image — no API key needed
curl -o insert.png "https://qrcode-suite.com/api/qr/k7Qm2x?format=png&size=600"
# Print file: 25 mm wide at 300 DPI
curl -o insert-print.png "https://qrcode-suite.com/api/qr/k7Qm2x?format=png&dpi=300&mm=25"¿Usa el plugin de WordPress?
El plugin de WordPress tiene sus propias rutas REST en su sitio, bajo /wp-json/qrcode-suite/v1/, autenticadas con claves creadas en la administración del plugin (Authorization: Bearer o X-API-Key). También añade el comando de WP-CLI wp qrcs con create, scan-stats, bulk-export, webhook-test y label-generate. Esas rutas actúan sobre los códigos guardados en WordPress; la API de la plataforma, sobre su espacio de trabajo. Si conecta el sitio a la plataforma (opcional), sus códigos, los totales diarios de escaneos y las conversiones de WooCommerce aparecen en su panel.
Preguntas frecuentes
¿Qué es QRCode Suite?
QRCode Suite es una plataforma QR independiente: cree una cuenta gratuita y genere códigos QR dinámicos y personalizados en el navegador — sin necesidad de WordPress. Los conectores llevan los mismos códigos a WordPress y WooCommerce, donde los pedidos pueden atribuirse a códigos QR específicos.
¿QRCode Suite funciona sin WordPress?
Sí. QRCode Suite es un SaaS independiente: regístrese, cree sus códigos QR y siga los escaneos íntegramente en qrcode-suite.com. El plugin de WordPress es un conector opcional que lleva sus códigos a wp-admin y añade la atribución de pedidos WooCommerce.
¿QRCode Suite requiere una suscripción aparte?
El plan Free está disponible sin coste — sin tarjeta de crédito. Los planes de pago (Pro 9 €, Business 29 €, Agency 79 € al mes) desbloquean códigos ilimitados, reglas de redirección y más. No hay tarifa por escaneo.
¿Qué tipos de códigos QR admite QRCode Suite?
QRCode Suite admite 22 tipos de códigos QR: URL estática, URL dinámica, Texto plano, Teléfono, Email, Ubicación, Link Hub, SMS, WhatsApp, Wi-Fi, vCard, Perfil social, PDF, Descarga de archivo, Descarga de app, Cupón, Evento de calendario, Formulario de captación de leads, Recogida de reseñas, Solicitud mayorista, Recompensa de fidelidad y Payload personalizado.
¿Puedo cambiar el destino de un código QR después de imprimirlo?
Sí. Los códigos QR dinámicos utilizan una URL de redirección corta. Puede actualizar el destino desde su panel en cualquier momento, sin regenerar ni reimprimir el código.
¿QRCode Suite cumple con el RGPD?
QRCode Suite está diseñado pensando en el RGPD: nunca se guardan IPs en bruto —los visitantes se cuentan con hashes con clave—, el tráfico de bots se filtra automáticamente y los eventos de escaneo se purgan cuando vence la ventana de retención de su plan. Consulte a su equipo legal para sus obligaciones específicas.
Construya sobre la API de QRCode Suite
Claves API con scopes y endpoints REST — incluidos desde Business.