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.
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
Crea códigos QR estáticos con una API pública. Código QR estático. Descargar SVG, PNG, JPG, WebP, PDF, EPS. escaneo. checklists de preimpresión QR. Vista previa. Personalizar código QR. Sin cuenta. Keep the destination, owner, file name, publication channel, proof result, and review date with the campaign notes so printed and shared QR assets can be checked later.
Crea códigos QR estáticos con una API pública. código QR de URL. Créalo en tu navegador. impresión. uso digital. Accesibilidad. seguridad y privacidad de QR. formatos de archivo QR. lector de códigos QR. Use the same checklist for websites, posters, packaging, receipts, menus, classroom handouts, payment notices, and customer support material.
código QR de URL: HTTPS
Crea códigos QR estáticos con una API pública: código QR de URL, Créalo en tu navegador, HTTPS, escaneo. Código QR estático. Enlaces listos para analítica. UTM. seguridad y privacidad de QR.
Seleccionar formato
impresión: SVG, PDF, EPS. uso digital: PNG, JPG, WebP, SVG. formatos de archivo QR. Descargar. Exportación vectorial. Seleccionar formato.
escaneo
escaneo. Vista previa. lector de códigos QR. checklists de preimpresión QR. impresión. uso digital. Personalizar. Test the generator preview, downloaded file, placed artwork, CMS upload, exported PDF, and one physical proof before approving production.
Empresa
Crea códigos QR estáticos con una API pública: código QR de URL, Descargar, SVG, PNG, JPG, WebP, PDF, EPS, impresión, uso digital, escaneo. Empresa. Guías. Comentarios.
API de códigos QR
API de códigos QR. OpenAPI. WebMCP. ai.txt. llms.txt. flujos de QR en lote. Descargar SVG, PNG, JPG, WebP, PDF, EPS. Código QR estático.
QR estáticos frente a dinámicos
Crea códigos QR estáticos con una API pública. Código QR estático. Sin límite de escaneos. código QR de URL. Enlaces listos para analítica. seguridad y privacidad de QR. Créalo en tu navegador. escaneo.
Comentarios
código QR de URL. código QR de llamada. código QR de email. Accesibilidad. escaneo. Comentarios. código QR de SMS.
Accesibilidad
Accesibilidad. escaneo. impresión. uso digital. código QR de URL. Créalo en tu navegador. Vista previa.
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?
Sí. Las páginas activas registran herramientas generate_qr y generate_bulk_qr cuando modelContext está disponible, y exponen marcado declarativo de formularios para lectores que leen atributos toolname.
¿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.