+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 cuenta de suscripción activa en QRStuff. El acceso a la API está incluido en todos los planes de suscripción de pago. Los planes Enterprise ofrecen límites de tasa más altos y soporte prioritario para aplicaciones de alto volumen.
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: Tenga en cuenta los límites de tasa basados en su nivel de suscripción. Los planes estándar admiten el uso típico de aplicaciones, mientras que los planes Enterprise ofrecen límites significativamente más altos para aplicaciones críticas de alto volumen.
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.
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)