API de códigos QR
La API de QR Code Crafter crea archivos QR estáticos mediante un punto de conexión público de Netlify Functions. Sirve para herramientas internas, agentes de IA, plantillas de campaña, catálogos y flujos de trabajo que generan archivos QR desde datos estructurados.
Puede codificar URL, Wi-Fi, vCard, eventos, ubicaciones, datos de pago, enlaces de tienda de apps, perfiles sociales y texto simple. El resultado es un archivo QR descargable, no una redirección dinámica obligatoria.
Los agentes pueden descubrir el contrato con OpenAPI, WebMCP, ai.txt, llms.txt y herramientas de ejecución en las páginas activas. Así no necesitan adivinar parámetros ni leer formularios visualmente.
OpenAPI GenerateQrRequest: x-agent-recipes. WebMCP: api.agentRecipes. Payment content: PhonePe-compatible UPI, Swiss QR-bill, SEPA/GiroCode, iDEAL, MobilePay/Vipps, QRIS.
Para un archivo único, llama a /.netlify/functions/generate-qr por GET o POST. POST JSON es preferible para URL largas, vCard, eventos, Wi-Fi, logotipos y flujos que necesitan validar metadatos de archivo.
Para varios archivos, llama a /.netlify/functions/generate-qr-bulk con CSV u objetos de fila JSON. El punto de conexión devuelve un ZIP con archivos QR, manifest.csv y manifest.json, limitado públicamente a 50 filas por solicitud.
Revisión independiente de funciones
Revisado el
Decisiones clave
Punto de conexión de QR único
GET con parámetros o POST JSON a generate-qr crea un archivo QR. La respuesta POST incluye base64 data, filename, content type, extension, width, height y unit.
Descubrimiento legible por agentes
/.well-known/openapi.json, /openapi.yaml, /.well-known/webmcp.json, /ai.txt y /llms.txt describen esquemas, límites, formatos y ejemplos de solicitud.
Seis formatos de exportación
La misma solicitud puede producir SVG, PNG, JPG, WebP, PDF o EPS. Usa SVG/PDF/EPS para impresión y diseño, PNG/WebP para publicación digital.
Flujo de generación QR por lotes
El punto de conexión por lotes procesa hasta 50 filas y devuelve un archivo ZIP con códigos QR y manifiestos legibles por máquina.
Modelo estático con menos dependencia
La carga útil queda dentro del patrón QR. El escaneo no depende de una cuenta de proveedor, suscripción activa, cuota de escaneos ni redirección alojada.
Metadatos verificables
Un agente puede comprobar byteLength, dimensions, extension, contentType, fileCount y manifest antes de enviar archivos a CMS, Drive, imprenta u otra herramienta.
Opciones de solicitud de la API QR
| Opción | Valor aceptado | Uso |
|---|---|---|
| Punto de conexión individual | GET o POST /.netlify/functions/generate-qr | Crea un archivo QR estático desde la carga útil final. |
| Punto de conexión por lotes | POST /.netlify/functions/generate-qr-bulk | Crea un ZIP desde filas CSV u objetos de fila JSON. |
| Límite del lote | 1-50 filas por solicitud | Mantiene automatizaciones públicas y agentes dentro de límites seguros. |
| format | svg, png, jpg, webp, pdf, eps | Elige el tipo de archivo para web, documentos, diseño o impresión. |
| size | 256-4096 | Define dimensiones para imágenes rasterizadas y exportaciones de maquetación. |
| errorCorrectionLevel | L, M, Q, H | Elige H para logo, impresión o contextos de escaneo más exigentes. |
| Metadatos de respuesta | contentType, extension, byteLength, width, height, unit | Confirma que el archivo guardado coincide con la solicitud. |
| Archivos de descubrimiento | OpenAPI, WebMCP, ai.txt, llms.txt | Ayuda a agentes y clientes API a leer parámetros actuales sin adivinar. |
| Medición de campaña | Codificar URL UTM o redirección propia | Un QR estático no crea dashboard de proveedor; la medición vive en el destino. |
Cómo deben llamar los agentes a la API QR
Un flujo fiable empieza con los archivos de descubrimiento, construye la carga útil final, elige formato y valida metadatos antes de la entrega.
Empezar por descubrimiento
Lee /ai.txt, /llms.txt o /.well-known/openapi.json para usar el punto de conexión, el esquema, los ejemplos y los formatos soportados actuales.
Usar POST para automatización
POST JSON evita límites de cadena de consulta para URL largas, vCard, eventos, Wi-Fi, datos de pago y logotipos en URL de datos.
Usar GET para descarga directa
GET devuelve directamente el archivo binario y expone headers X-QR-Width, X-QR-Height, X-QR-Unit y X-QR-Bytes.
Validar el archivo guardado
Comprueba contentType, extension, byteLength, width, height y unit antes de enviar el archivo a CMS, Google Drive, imprenta u otro agente.
Flujo de generación QR por lotes
La generación por lotes sirve para etiquetas, materiales educativos, envases, menús, acreditaciones, variantes de campaña y archivos QR creados desde datos estructurados.
Enviar CSV u objetos de fila
Usa CSV filename,value o filas JSON con value y filename opcional. Las filas vacías, nombres inseguros y cargas útiles demasiado grandes se rechazan.
Elegir un formato común
Define SVG, PNG, JPG, WebP, PDF o EPS para todo el lote. SVG funciona bien para volumen automatizado; PDF o EPS para entrega a imprenta.
Pedir ZIP cuando haga falta archivo
Accept: application/zip devuelve un ZIP binario. La respuesta JSON sigue disponible cuando el agente necesita datos ZIP en base64, byteLength, fileCount y manifest.
Usar manifest para auditoría
manifest.csv y manifest.json conectan cada fila origen con filename, status y conteo de bytes para rastrear el resultado en el siguiente sistema.
Cargas útiles estáticas compatibles
La API codifica exactamente la carga útil enviada. Valida la cadena final en tu propio flujo antes de generar y publicar el archivo QR.
Enlaces de marketing y contenido
Codifica URL HTTPS, URL UTM, páginas de tienda de apps, perfiles sociales, menús, landing pages PDF, enlaces de reseña de Google y redirecciones propias.
Acciones de dispositivo
Codifica cadenas Wi-Fi, enlaces mailto, acciones SMS, enlaces de llamada, enlaces de WhatsApp, eventos de calendario, coordenadas de mapa y contactos vCard.
Cargas útiles de pago
Codifica SEPA, PIX EMV, UPI URI, enlaces Swish, PromptPay, VietQR y URI de billetera cripto tras validar destinatario, importe, memo y moneda.
Diseño e impresión
Usa SVG, PDF o EPS para arte final de producción; PNG, JPG o WebP para vista previa, documentos, correo y publicación web.
Checklist de integración para agentes
- Leer /ai.txt o /.well-known/openapi.json antes de construir la solicitud.
- Usar POST JSON para vCard, evento, Wi-Fi, pago, logotipo y cargas útiles largas.
- Limitar el punto de conexión por lotes a 50 filas máximo.
- Enviar Accept: application/zip cuando el agente necesita el ZIP binario directo.
- Definir un User-Agent claro para integraciones automatizadas.
- Respetar Retry-After en respuestas 429 y 503.
- Decodificar datos base64 desde la respuesta POST y guardar con la extensión devuelta.
- Validar byteLength, dimensions, fileCount y metadatos de manifest antes de la entrega.
- Hacer prueba de escaneo para cada tipo de contenido y formato exportado antes de producción.
- Para medición, crear la URL UTM o redirección propia antes de generar el QR.
Guías: impresión
API de códigos QR debe tratarse como un proceso de publicación, no solo como una imagen generada. Confirma el destino, elige el formato de exportación, prueba el archivo final y asigna una persona responsable antes de mostrar el código en material público.
Antes de usar API de códigos QR en material impreso, envases, señalización, correo electrónico, documentos, aplicaciones o automatizaciones, guarda una breve nota de publicación con el valor codificado, el nombre de archivo, el formato de exportación, la ubicación, la persona responsable y el resultado de la prueba. Ese registro permite corregirlo más adelante.
código QR de URL: HTTPS
Para API de códigos QR, comprueba que la URL codificada, los datos de contacto, la instrucción de pago, el archivo o la acción de la aplicación sean correctos, estén controlados por el equipo adecuado, funcionen en móviles y sean apropiados para quienes puedan escanear el código.
Seleccionar formato
Conserva archivos maestros SVG, PDF o EPS para impresión, envases, carteles y herramientas de diseño. Usa PNG, JPG, WebP o SVG en sitios web, correo electrónico, documentos y ubicaciones digitales, y evita comprimir el código final de forma inesperada.
escaneo
Antes de publicar, escanea la vista previa del navegador, el archivo descargado, el diseño colocado, el PDF exportado, la carga en el CMS, la vista previa de correo electrónico y la prueba física desde distancias, ángulos, condiciones de luz y dispositivos realistas.
Empresa
Registra la persona responsable del QR, el destino, el archivo fuente, el formato de exportación, la ubicación, la fecha de publicación, los dispositivos de prueba, la fecha de revisión y el criterio de sustitución para que los códigos QR estáticos de larga duración sigan siendo fiables.
API de códigos QR
Cuando necesites muchos archivos QR, utiliza nombres coherentes, comprobaciones de manifiesto, parámetros de OpenAPI o WebMCP y validación del formato de salida antes de entregar los recursos a los equipos de diseño, impresión o contenido.
QR estáticos frente a dinámicos
Revisa API de códigos QR después de cambios de campaña, renovaciones de marca, migraciones de dominio, actualizaciones de datos de pago, cambios en tiendas de aplicaciones, migraciones de documentos o cambios de analítica para que los códigos QR públicos no apunten a destinos obsoletos o inseguros.
Comentarios
Añade texto legible del destino, una URL corta, un contacto de soporte o una instrucción impresa cuando el escaneo sea esencial para la actividad, relevante para la accesibilidad o probable con conectividad limitada.
Accesibilidad
Coloca texto cercano que explique la acción de escanear, mantén un contraste alto, evita ubicaciones demasiado pequeñas y asegúrate de que el destino funcione con navegadores móviles, lectores de pantalla, ajustes de movimiento reducido y navegación por teclado.
Generar códigos QR vía API
- 1
Elegir individual o lote
Usa generate-qr para un archivo, o generate-qr-bulk para un ZIP con varios códigos QR estáticos.
- 2
Construir la carga útil final
Prepara URL, cadena Wi-Fi, vCard, evento, URI de pago, texto, CSV u objetos de fila exactamente como el lector debe interpretarlos.
- 3
Elegir formato de salida
Usa SVG/PDF/EPS para impresión y diseño; PNG/JPG/WebP para publicación digital y vista previa.
- 4
Verificar la respuesta
Confirma success, content type, byte length, dimensions, extension y manifest ZIP antes de guardar los archivos.
- 5
Probar en el contexto final
Escanea el archivo después de insertarlo en maquetación, CMS, documento o prueba impresa para verificar que el archivo automatizado funciona en la práctica.
Preguntas frecuentes
¿Cuál es el punto de conexión de la API de QR Code Crafter?
Usa /.netlify/functions/generate-qr con parámetros GET o cuerpo POST JSON para un QR. Para un ZIP por lotes, usa /.netlify/functions/generate-qr-bulk.
¿La API puede generar códigos QR por lotes?
Sí. Envía filas CSV u objetos de fila JSON al punto de conexión por lotes. La respuesta puede ser JSON con datos ZIP en base64 o directamente application/zip si la solicitud usa Accept: application/zip.
¿Necesito una cuenta para usar la API?
La generación pública está disponible sin cuenta mientras el despliegue no active la verificación de clave API. Si hay una clave emitida, envía X-Agent-Api-Key y gestiona respuestas 401.
¿Qué formatos de archivo devuelve la API?
El contrato público soporta SVG, PNG, JPG, WebP, PDF y EPS.
¿Los agentes de navegador pueden usar WebMCP?
WebMCP es un estándar propuesto y solo funciona en una pestaña visible o vista web compatible. Comprueba las herramientas generate_qr y generate_bulk_qr registradas en la página actual; un manifiesto por sí solo no permite invocarlas. Los clientes sin interfaz y del lado del servidor deben usar los puntos de acceso HTTP documentados por OpenAPI.
¿La API crea QR dinámicos con medición?
No. La API crea archivos QR estáticos. Para medir una campaña, codifica una URL UTM o una redirección propia antes de generar el código QR.
API de códigos QR: QR code generator API?
API de códigos QR: QR code generator API. API QR code generator. qrcode API. QR API. generate QR code API. SVG, PNG, JPG, WebP, PDF, EPS.