Ir al contenido principal
QR-Verse
REST API

Genera Códigos QR a Escala con Nuestra API REST

Integra creación, gestión y analítica de códigos QR en cualquier aplicación. API JSON RESTful con autenticación por clave API, exportación ZIP masiva y webhooks en tiempo real.

POST /api/v1/qr-codes
{ "type": "url", "data": "https://example.com" }

La API REST de QR-Verse permite a los desarrolladores crear, gestionar y rastrear códigos QR de forma programática. Exporta hasta 50 códigos existentes como archivo ZIP mediante el endpoint de exportación masiva, recibe notificaciones de escaneo en tiempo real mediante webhooks y accede a analíticas detalladas. Autentica con una clave API simple y comienza a integrar en minutos con cualquier cliente HTTP.

Crea un código QR en segundos

Una sola solicitud POST es suficiente. Envía tus datos y obtén un código QR escaneable con URL corta rastreable e imagen descargable.

Solicitud
cURL
curl -X POST \
https://qr-verse.com/api/v1/qr-codes \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Spring campaign",
"destination_url": "https://example.com"
}'
Respuesta
201 Created
{
"data": {
"id": "qr_abc123",
"name": "Spring campaign",
"qr_type": "url",
"destination_url": "https://example.com",
"is_active": true,
"redirect_slug": "abc123",
"tags": [],
"created_at": "2026-10-09T12:00:00Z"
}
}

Todo lo que necesitas para desarrollar

Una API completa para gestionar el ciclo de vida de los códigos QR. Desde la creación y el estilo hasta el seguimiento de escaneos y notificaciones en tiempo real.

Operaciones CRUD completas

Crea, lee, actualiza y elimina códigos QR programáticamente. Compatible con todos los tipos de QR: URL, vCard, WiFi, email, SMS y más.

Exportación ZIP masiva

Exporta hasta 50 códigos QR existentes como archivo ZIP en una sola solicitud API. Descarga PNG o SVG con el estilo original conservado.

API de analíticas

Recupera datos de escaneo programáticamente. Totales de un periodo y un registro por escaneo: hora, país, ciudad, tipo de dispositivo, sistema operativo, navegador y parámetros UTM.

Eventos de webhook

Recibe notificaciones HTTP en tiempo real cuando se escanean tus códigos QR. Activa flujos de trabajo en tu CRM, analíticas o herramientas de automatización.

Gestión de claves API

Genera, rota y revoca claves API desde tu panel de control. Los planes Pro y Business admiten múltiples claves para distintos entornos.

Límite de tasa

Crear códigos QR a través de la API está limitado a 30 solicitudes por 60 segundos por clave API. Por encima de ese límite, la API responde con el estado 429.

Acceso a la API según el plan

El acceso a la API empieza con Pro. Business añade la importación masiva desde un archivo CSV en la interfaz web y límites más altos de webhooks y claves API para entornos de equipo.

Función
Gratis
EUR 0/mes
Pro
4,99 €/mes
Business
12,99 €/mes
Acceso REST API
Gestión de claves API
Crear / Leer / Actualizar / Eliminar
Códigos QR dinámicos desde una URL de destino
Recuperación de datos de analíticas
Límite de tasa (crear códigos)030 / min30 / min
Exportación ZIP masiva (hasta 50 códigos)
Notificaciones por webhook
Múltiples claves API

Diseñado para tu tecnología

Tanto si gestionas una tienda online, administras embudos de ventas o automatizas campañas de marketing, la API de QR-Verse encaja en tu flujo de trabajo existente.

Plataformas de e-commerce

Genera códigos QR para cada producto de tu catálogo automáticamente. Enlaza a páginas de producto, añádelos al packaging o incrústalos en recibos. Exporta códigos existentes como archivo ZIP mediante la API para flujos de trabajo de impresión y embalaje.

Shopify, WooCommerce o tiendas personalizadas

CRM y herramientas de ventas

Crea códigos QR personalizados para material de ventas, tarjetas de visita o portales de clientes. Usa webhooks para registrar escaneos como actividades en el CRM y rastrear la interacción por contacto.

HubSpot, Salesforce, Pipedrive

Automatización de marketing

Inserta códigos QR dinámicos en campañas de email, anuncios impresos o materiales de eventos. Recupera analíticas de escaneos vía API para medir el ROI de la campaña junto con tus datos de marketing existentes.

Mailchimp, ActiveCampaign, Zapier

Experiencia para desarrolladores

Creada por desarrolladores, para desarrolladores. Respuestas predecibles, documentación clara y versiones estables para que puedas desplegar con confianza.

Claves API con permisos

Da a cada clave solo los permisos que necesita: qr:read, qr:write, qr:create y analytics:read. Una clave sin el permiso de un endpoint recibe un 403, y un token de sesión iniciada no se acepta en la API.

Respuestas JSON

Respuestas JSON limpias y consistentes con estructura predecible. Cada endpoint devuelve el mismo formato: datos, paginación y objetos de error en los que puedes confiar.

Manejo de errores

Respuestas de error estructuradas con códigos de estado HTTP, códigos de error legibles por máquina y mensajes legibles por humanos. Diagnostica problemas rápidamente sin adivinar.

Versionado de API

Endpoints de API versionados (v1) con garantías de compatibilidad hacia atrás. Los cambios incompatibles solo se incluyen en nuevas versiones principales, para que tu integración sea estable.

Endpoints disponibles
GET/api/v1/qr-codes
POST/api/v1/qr-codes
GET/api/v1/qr-codes/:id
PATCH/api/v1/qr-codes/:id
DELETE/api/v1/qr-codes/:id
GET/api/v1/qr-codes/:id/scans

Preguntas frecuentes

¿Qué método de autenticación usa la API de QR-Verse?
La API usa autenticación por clave API mediante tokens Bearer. Incluye tu clave API en la cabecera Authorization como "Bearer TU_CLAVE_API". Puedes generar y gestionar claves API desde el panel de tu cuenta.
¿Qué tipos de código QR puedo crear a través de la API?
La API crea códigos QR dinámicos que redirigen a una URL de destino: envía un name y una destination_url a POST /api/v1/qr-codes. El campo type es una etiqueta (url, link, text, email, wifi, vcard, sms, phone, geo, event, crypto o social) y el contenido es siempre la URL. Los códigos con datos propios, como una vCard o una red WiFi, se crean en la aplicación web.
¿Cómo funciona la exportación ZIP masiva?
Los usuarios de los planes Pro y Business pueden exportar hasta 50 códigos QR existentes como archivo ZIP mediante POST /api/qr/bulk-export, con una sesión o una clave API con el permiso qr:read. Especifica los IDs de los códigos a exportar y elige el formato PNG o SVG. La API devuelve una descarga ZIP con cada código como archivo individual con su estilo original conservado.
¿Qué ocurre cuando alcanzo el límite de tasa?
Crear un código (POST /api/v1/qr-codes) está limitado a 30 solicitudes por ventana de 60 segundos por clave API. Por encima de ese límite, la API responde con el estado 429 y el mensaje "Rate limit exceeded". Las respuestas no incluyen cabeceras de límite de tasa ni hora de restablecimiento: espera un minuto y vuelve a intentarlo.
¿Puedo personalizar el aspecto de los códigos QR vía API?
No a través de la API v1. Un código creado con la API empieza con el estilo predeterminado (negro sobre blanco); después puedes cambiar su estilo en la aplicación web. Los colores, la corrección de errores y el formato de salida no son parámetros de POST /api/v1/qr-codes.
¿Cómo funcionan los webhooks para eventos de escaneo?
Los usuarios de los planes Pro y Business pueden registrar URLs de webhook desde el panel. Cuando se escanea cualquiera de tus códigos QR, enviamos una solicitud POST a tu URL de webhook con los detalles del escaneo: el evento y una marca de tiempo, más el ID y el nombre del código QR, país y ciudad, tipo de dispositivo, sistema operativo, navegador, si el escaneo es único y los parámetros UTM (sin referente). Los webhooks usan firmas HMAC para verificación.
¿La API está disponible en el plan gratuito?
No. El acceso a la API requiere un plan Pro (4,99 €/mes) o Business (12,99 €/mes). El plan gratuito incluye el generador QR basado en web pero no acceso programático a la API.
¿Puedo recuperar datos de analíticas a través de la API?
Sí. Tanto los planes Pro como Business incluyen acceso API a las analíticas de escaneo, con una clave que tenga el permiso analytics:read. GET /api/v1/qr-codes/:id/scans devuelve los escaneos de un código QR por páginas (hora, país, ciudad, tipo de dispositivo, sistema operativo, navegador, único o no, parámetros UTM) y un resumen con el total de escaneos, los escaneos y escaneos únicos del periodo y la duración del periodo. No devuelve un desglose por día, semana o mes ni el referente: agrega los registros por tu cuenta.

Integrando códigos QR en tu flujo de trabajo

La API REST de QR-Verse te permite generar, gestionar y recuperar análisis de escaneos para códigos QR de forma programática. Cada operación disponible en el panel también está disponible a través de la API, lo que significa que tu equipo de desarrollo puede integrar la generación de códigos QR directamente en herramientas internas, plataformas de comercio electrónico, cadenas de cumplimiento o productos SaaS sin pasos manuales.

Los patrones de integración comunes incluyen la generación programática: crear códigos QR únicos, una solicitud a la vez, cada uno con una URL de destino distinta y metadatos personalizados opcionales. Esto es ideal para la serialización de productos, sistemas de tickets o programas de tarjetas de fidelidad donde cada artículo físico necesita su propio código escaneable. La API devuelve cada código generado como SVG o PNG en el cuerpo de la respuesta.

El endpoint de análisis de escaneos proporciona acceso en tiempo real a los mismos datos visibles en el panel: escaneos totales, escaneos únicos, desglose geográfico, desglose por dispositivo y datos de series temporales, todo en JSON estructurado. Esto significa que puedes canalizar eventos de escaneo QR directamente a tu propio almacén de datos, CRM o herramienta de informes. El soporte de webhooks está disponible en los niveles Pro y Business.

La API es pequeña a propósito: seis endpoints bajo /api/v1, JSON de entrada y de salida, y una clave API con permisos para el acceso. Los endpoints están en esta página, y el ejemplo de abajo muestra una solicitud y su respuesta. No hay paquetes SDK ni documentación interactiva alojada: basta un cliente HTTP sencillo, como cURL o fetch.

Se requiere plan Pro

Obtén tu clave API

Regístrate en un plan Pro o Business, genera tu clave API desde el panel de control y empieza a hacer solicitudes en minutos.

Empieza a desarrollar