QR-Verse
REST API

API de Códigos QR para Desarrolladores

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, operaciones masivas y webhooks en tiempo real. Desde un código hasta 500 por solicitud.

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

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 '{
"type": "url",
"data": "https://example.com",
"style": { "foreground": "#238636" }
}'
Respuesta
201 Created
{
"id": "qr_abc123",
"type": "url",
"shortUrl": "https://qr-verse.com/r/abc123",
"image": "https://qr-verse.com/api/v1/qr-codes/qr_abc123/image.svg"
}

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.

Operaciones masivas

Crea hasta 500 códigos QR en una sola solicitud API. Ideal para catálogos de e-commerce, entradas de eventos o gestión de inventario.

API de analíticas

Recupera datos de escaneo programáticamente. Total de escaneos, escaneos a lo largo del tiempo, desglose geográfico, tipos de dispositivo y datos de referidos.

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 Business admiten múltiples claves para distintos entornos.

Límite de tasa

Cabeceras de límite de tasa claras en cada respuesta. Pro: 100 llamadas/día. Business: 10.000 llamadas/día. Nunca adivines tu cuota restante.

Acceso a la API según el plan

El acceso a la API empieza con Pro. Business desbloquea operaciones masivas, webhooks y 100 veces el límite diario de llamadas.

Función
Free
EUR 0
Pro
EUR 4.99/mo
Business
EUR 12.99/mo
Acceso REST API
Gestión de claves API
Crear / Leer / Actualizar / Eliminar
Todos los tipos de QR (URL, vCard, WiFi...)
Recuperación de datos de analíticas
Llamadas API por día010010.000
Operaciones masivas (por solicitud)Hasta 500
Notificaciones por webhook
Múltiples claves API
Respuestas API en marca blanca
Documentación OpenAPI / Swagger
Empieza con ProComparar todos los planes

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. Crea 500 códigos en masa por llamada API para inventarios grandes.

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.

Documentación OpenAPI

Especificación completa OpenAPI 3.0 con Swagger UI interactivo. Prueba los endpoints directamente desde la documentación. Cada esquema de solicitud y respuesta documentado.

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
POST/api/v1/qr-codes
GET/api/v1/qr-codes/:id
PATCH/api/v1/qr-codes/:id
DELETE/api/v1/qr-codes/:id
POST/api/v1/qr-codes/bulk
GET/api/v1/qr-codes/:id/analytics

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?
Todos los tipos de código QR disponibles en la interfaz web también están disponibles vía API: URL, vCard (tarjetas de contacto), credenciales de red WiFi, email, SMS, texto plano y más. Cada tipo tiene su propio esquema de datos documentado en la especificación OpenAPI.
¿Cómo funciona la creación masiva de códigos QR?
Los usuarios del plan Business pueden enviar un array de hasta 500 objetos de código QR en una sola solicitud POST al endpoint masivo. Cada código puede tener distintos tipos, datos y estilos. La API devuelve todos los códigos creados con sus IDs y URLs cortas.
¿Qué ocurre cuando alcanzo el límite de tasa?
Cada respuesta de la API incluye cabeceras de límite de tasa: X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset. Cuando superas tu límite, la API devuelve un código de estado 429 con el sello de tiempo de restablecimiento. Los planes Pro tienen 100 llamadas/día, los planes Business 10.000.
¿Puedo personalizar el aspecto de los códigos QR vía API?
Sí. La API acepta parámetros de estilo como color de primer plano, color de fondo, nivel de corrección de errores y formato de salida (SVG o PNG). Las mismas opciones de personalización disponibles en el generador web están disponibles a través de la API.
¿Cómo funcionan los webhooks para eventos de escaneo?
Los usuarios del plan 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: ID del código QR, marca de tiempo, ubicación (país/ciudad), tipo de dispositivo y referido. 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 (EUR 4.99/mes) o Business (EUR 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 escaneos. Puedes recuperar totales de escaneos, escaneos a lo largo del tiempo (diario/semanal/mensual), desglose geográfico por país y ciudad, tipos de dispositivo y principales referidos para cualquiera de tus códigos QR.
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. Documentación OpenAPI completa incluida.

Empieza a desarrollar