+40 tipos de códigos QR
URL, vCards, pagos y más
Analíticas en tiempo real
Escaneos, dispositivos y ubicaciones
Procesamiento por lotes
Operaciones a escala empresarial
Véalo en acción
Explore cómo la API genera diferentes estilos de códigos QR con llamadas simples a la API.
Generación simple de códigos QR
Cree códigos QR estándar para uso interno, identificaciones de empleados, acreditaciones de eventos y documentación técnica.
curl -X POST 'https://api.qrstuff.com/api/qr-codes' \
-H "Authorization: Bearer [key]" \
-H "Content-Type: application/json" \
-d '{
"type": "website",
"data": "https://example.com"
}'
{
"id": "qr_8f3k2m1n",
"status": "active",
"short_url": "https://qrs.tf/a1b2",
"image_url": "https://cdn...",
"created_at": "2026-02-12"
}
Código QR de marca personalizada
Personalice sus códigos QR con colores de marca para materiales de venta minorista, hostelería y marketing.
curl -X POST 'https://api.qrstuff.com/api/qr-codes' \
-d '{
"style": {
"foreground": "#5D4696",
"marker": "#E5006C"
}
}'
{
"id": "qr_9x4j7p2q",
"style": {
"foreground": "#5D4696",
"marker": "#E5006C"
}
}
Resumen de la API
La API de QRStuff es una API RESTful integral que permite a los desarrolladores integrar funcionalidades avanzadas de códigos QR directamente en sus aplicaciones. Ya sea que esté creando una aplicación móvil, una plataforma web o un sistema empresarial, nuestra API proporciona todo lo necesario para crear, gestionar y rastrear códigos QR dinámicos a escala.
Características clave
Resumen general
Gestión de proyectos: Cree y organice códigos QR en proyectos, gestione la configuración del proyecto, mueva códigos QR entre proyectos, restaure proyectos eliminados y mantenga una organización estructurada de códigos QR en toda su aplicación.
40+ QR Code Types
Más de 40 tipos de códigos QR: Genere códigos QR para sitios web, detalles de contacto (vCard), redes sociales (Facebook, Instagram, LinkedIn, Twitter, YouTube, TikTok, Snapchat), métodos de pago (PayPal, Bitcoin, UPI, Venmo, Zelle), credenciales WiFi, eventos, ubicaciones, carga de archivos (PDF, imágenes, audio, video), SMS, correo electrónico, números de teléfono y muchos más formatos especializados.
Comprehensive Analytics
Analíticas integrales: Acceda a analíticas de escaneo detalladas que incluyen escaneos totales, desgloses por dispositivo (iOS, Android, escritorio, tableta), datos geográficos con seguimiento a nivel de país y ciudad, información basada en el tiempo que muestra los periodos de mayor escaneo, identificación de usuarios únicos y datos gráficos visuales para presentaciones e informes.
Batch Processing
Procesamiento por lotes avanzado: Gestione eficientemente grandes despliegues de códigos QR con capacidades de descarga masiva compatibles con múltiples formatos de archivo (PNG, SVG, EPS, PDF), configure diseños de impresión para impresión por lotes con plantillas personalizables, mueva múltiples códigos QR entre proyectos simultáneamente y maneje operaciones a escala empresarial sin problemas.
File Management
Sistema de gestión de archivos: Almacene y recupere archivos para códigos QR que requieren contenido alojado: cargue PDF para folletos, imágenes para galerías, archivos de audio para compartir música, archivos de video para contenido promocional y cualquier otro tipo de archivo al que sus códigos QR necesiten enlazar.
Preview & Customization
Vista previa y personalización: Genere URL de vista previa para cualquier tipo de código QR antes de su creación para validar los datos y la apariencia, personalice elementos de diseño incluyendo colores, patrones y logotipos, controle los niveles de corrección de errores para diferentes casos de uso y garantice resultados perfectos antes del despliegue.
Primeros pasos
Antes de comenzar la integración con la API de QRStuff, asegúrese de haber completado los siguientes requisitos de configuración para permitir una integración fluida:
Active Subscription
Suscripción activa: Debe tener una suscripción de pago activa en un plan que incluya acceso a la API.
API Credentials
Credenciales de la API: Obtenga su clave de API única y su token de autenticación desde el panel de control de su cuenta, en la sección API. Estas credenciales son necesarias para todas las solicitudes autenticadas y deben mantenerse seguras.
Base URL Configuration
Configuración de la URL base: Todas las solicitudes de la API deben realizarse al punto de enlace base https://api.qrstuff.com. Asegúrese de que su aplicación pueda realizar solicitudes HTTPS a este dominio sin restricciones de firewall o proxy.
Authentication Setup
Configuración de autenticación: Incluya sus credenciales de API en el encabezado de Autorización para todos los puntos de enlace autenticados. Utilice el formato de autenticación Bearer token para garantizar una comunicación segura entre su aplicación y la API.
Content Type Headers
Encabezados de tipo de contenido: Todas las solicitudes deben enviarse con el encabezado Content-Type: application/json, y todas las respuestas se devolverán en formato JSON para facilitar su análisis e integración.
Rate Limit Awareness
Conocimiento del límite de tasa: Cada clave de API está limitada a 60 solicitudes por minuto, 1.000 solicitudes por hora y 10.000 solicitudes por día. Estos límites son uniformes en todos los planes que incluyen acceso a la API (Full Suite y Enterprise) y se aplican por clave de API, por lo que dos claves de la misma cuenta nunca comparten un cupo. Cuando se alcanza un límite, la API responde con HTTP 429 y un encabezado Retry-After que indica exactamente cuántos segundos esperar antes de reintentar.
Ejemplo de autenticación
Incluya su clave de API en el encabezado de Autorización para todas las solicitudes autenticadas. Aquí tiene un ejemplo básico de cómo estructurar sus llamadas a la API:
curl -X POST 'https://api.qrstuff.com/api/projects' \
-H "Authorization: Bearer [your_api_key]" \
-H "Content-Type: application/json" \
-d '{
"name": "Project Name"
}'Puntos de enlace (Endpoints) de la API
Explore the complete set of endpoints available for integrating QR code functionality into your applications.
| POST | /projects | Create a new project container for organizing QR codes |
| GET | /projects/{id} | Retrieve detailed information about a specific project |
| PUT | /projects/{id} | Update project details, settings, and configuration |
| GET | /projects | List all projects with filtering, sorting, and pagination |
| DELETE | /projects/{id} | Remove projects with soft deletion and retention |
| POST | /projects/{id}/restore | Recover deleted projects within retention period |
| POST | /qr-codes | Generate a new QR code with 40+ data types and customizations |
| GET | /projects/{id}/qr-codes | Retrieve all QR codes from a project with pagination |
| PUT | /qr-codes/{id} | Update QR code content, URLs, design, and settings |
| POST | /api/qrcodes/anonymous-transfer | Transfer QR codes between projects in bulk |
| DELETE | /qr-codes/{id} | Remove QR codes with optional soft delete and recovery |
| POST | /api/batch/submit | Initiate processing of a large batch file |
| GET | /api/qrcodes/{id}/zip/download | Download ZIP archive of all generated images |
| POST | /api/batch/unpack | Extract all QR codes from a completed batch archive |
| POST | /api/batch/update | Update properties across multiple QR codes simultaneously |
| GET | /analytics/scans | Cumulative scan counts with date range filtering |
| GET | /analytics/scans/devices | Breakdown by device type and operating system |
| GET | /analytics/location | Geographic data with country, state, and city-level detail |
| GET | /analytics/top-location | Discover regions with highest engagement rates |
| GET | /analytics/top-date | Identify peak scanning days and dates |
| GET | /analytics/time-of-day | Hourly breakdown of scanning patterns |
| GET | /analytics/unique-users | Track individual user engagement and loyalty |
| GET | /analytics/charts/country | Country-wise distribution for charting libraries |
| GET | /analytics/charts/time | Time-series data for visual scan pattern charts |
| POST | /files | Upload files (PDF, images, audio, video) with validation |
| GET | /files/{id} | Retrieve file info, download URLs, and metadata |
| GET | /files | Browse uploaded files with pagination and filtering |
| DELETE | /files/{id} | Remove files with active-use protection check |
Tipos de códigos QR compatibles (+40 formatos)
Genere códigos QR para una extensa variedad de casos de uso. Cada tipo tiene parámetros específicos detallados en la documentación:
Información básica y de contacto
7Plataformas de redes sociales
15Ubicación y eventos
3Archivos y documentos
5Pagos y transacciones
5Marketing y compromiso
6Utilidad y negocios
4Nota: Cada tipo de código QR tiene requisitos de parámetros específicos. Consulte la documentación completa en api.qrstuff.com/docs para obtener especificaciones completas.
Mejores prácticas
Use códigos QR dinámicos: Siempre que sea posible, genere códigos QR dinámicos a través de la API. Estos permiten actualizar el contenido sin volver a imprimir, rastrear analíticas detalladas y realizar pruebas A/B.
Implemente un manejo de errores robusto: Compruebe siempre los códigos de estado HTTP (200, 400, 401, 429, 500) y maneje los límites de tasa con estrategias de reintento.
Aproveche las operaciones por lotes: Para múltiples códigos QR, use los endpoints por lotes para mejorar el rendimiento y mantenerse dentro de los límites de tasa.
Implemente caché inteligente: Almacene en caché imágenes de códigos QR y datos estáticos para reducir llamadas innecesarias, pero mantenga fresca la analítica para informes precisos.
Enfoque de seguridad primero: Nunca exponga sus claves de API en código del lado del cliente. Use variables de entorno y rote las claves periódicamente.
Ciclo de vida y rotación de claves: Cada plan permite un número fijo de claves de API activas (Full Suite hasta 3, Enterprise hasta 10). Regenerar una clave invalida la anterior de inmediato; despliegue la nueva clave en sus aplicaciones antes de regenerar. Elimine las claves no utilizadas con prontitud y revise la lista con regularidad. Si cambia a un plan con un límite menor, las claves excedentes se revocan automáticamente, lo que puede interrumpir las integraciones activas.
Respete los límites de tasa: La API aplica tres ventanas fijas independientes por clave de API: 60 solicitudes / minuto, 1.000 solicitudes / hora y 10.000 solicitudes / día. Estos límites se aplican por clave de API y son los mismos para los planes Full Suite y Enterprise, por lo que dos claves de la misma cuenta nunca comparten un cupo. Cuando supere cualquiera de estas ventanas, la API responde con HTTP 429 y un encabezado Retry-After. Si se superan varias ventanas a la vez, el encabezado apunta a la espera más larga, de modo que respetarlo nunca lo devuelve a otra ventana que también esté en infracción. Respete siempre el encabezado Retry-After y añada en su cliente reintentos con back-off exponencial automático, jitter y una pequeña cola de solicitudes para que los picos no se conviertan en cascadas de 429.
Casos de uso y ejemplos reales
Plataforma de gestión de eventos y venta de entradas
Integre la generación de códigos QR para la distribución de entradas y el seguimiento de asistentes. Cree códigos únicos para cada entrada, rastree la asistencia en tiempo real y gestione eventos concurrentes organizándolos en proyectos específicos.
Sistemas de gestión de inventario y activos
Cree sistemas de seguimiento de activos con integración fluida de códigos QR. Genere códigos únicos para cada producto o equipo y rastree su ubicación y movimiento mediante analítica geográfica.
Gestión de campañas de marketing y analítica
Cree campañas de marketing sofisticadas con códigos QR rastreables. Actualice las páginas de destino sin volver a imprimir materiales y mida la efectividad mediante analíticas geográficas y temporales detalladas.
Distribución de contenido educativo y compromiso
Mejore los materiales educativos con códigos QR que enlazan a videos, modelos 3D o cuestionarios interactivos. Organice el contenido por curso o materia y rastree el compromiso de los estudiantes.
Gestión de restaurantes y hostelería
Implemente menús digitales y sistemas de pedido sin contacto. Actualice los precios y platos en tiempo real y recopile comentarios de los clientes inmediatamente después de su experiencia.
English (US)
English (UK)
French (FR)