Un código. Tu próxima conexión.Escanea para descubrirUna petición por código
Envía el tipo, un nombre y el contenido. Añade diseño, carpeta y etiquetas en la misma petición.
Guía para desarrolladores
Crea cientos de códigos QR desde tu propio sistema.
Genera un código para cada producto, mesa o cartel desde una hoja de cálculo o tu software, y cámbialos todos después sin reimprimir.
Respuesta rápida
La API REST y los webhooks están cerrados por ahora. Puedes preparar claves en Ajustes → Desarrolladores. La disponibilidad de MCP se controla por separado. La API REST de QRflick crea y gestiona QR dinámicos desde tu propio código. Crea una clave de API en Ajustes → Desarrolladores y envía POST https://qrflick.com/api/v1/qr-codes con el tipo, el nombre y el contenido de cada código. Cada código tiene un enlace corto que puedes cambiar, estadísticas de escaneo y archivos PNG, SVG, PDF y EPS listos para imprimir.
Reintentos seguros
Envía una cabecera Idempotency-Key en cada creación. Si una petición se repite tras un fallo de red, no se duplica el código.
Archivos de impresión
Descarga cada código en PNG, SVG, PDF o EPS con el tamaño y la resolución que necesite tu imprenta.
Estadísticas y webhooks
Consulta los escaneos por día y sus desgloses, o recibe un webhook cuando se crea o escanea un código.
De la idea a la conexión
Que sea útil. Que esté al día.
- 1 Crea una clave de APIAbre Ajustes → Desarrolladores y crea una clave con permiso de escritura. Cópiala ahora: solo se muestra una vez.
- 2 Envía tu primera peticiónHaz POST a /api/v1/qr-codes con tu clave en la cabecera Authorization.
- 3 Recorre tu listaCrea un código por fila de tu hoja de cálculo o base de datos, con una Idempotency-Key por fila.
- 4 Descarga e imprimeObtén el archivo de impresión de cada código en /api/v1/qr-codes/{id}/image.
En detalle: Crea cientos de códigos QR desde tu propio sistema
¿Cómo es una petición de creación?
Empieza con GET /api/v1/me para verificar el espacio de trabajo, el acceso de la clave y los límites actuales. Guarda la clave en el servidor, nunca en JavaScript del navegador ni en una aplicación móvil.
POST https://qrflick.com/api/v1/qr-codes con las cabeceras Authorization: Bearer api_… y Content-Type: application/json, y un cuerpo como {"type": "url", "name": "Mesa 12", "payload": {"url": "https://example.com/carta"}, "folder": "Mesas"}.
La respuesta incluye el id del código, su enlace corto y su diseño completo. Guarda el id junto a tu propio registro para poder actualizar el código más tarde.
¿Cómo creo códigos en bloque?
Recorre tu lista y envía una petición de creación por fila, con una Idempotency-Key distinta en cada una (por ejemplo, el id de la fila). Respeta las peticiones por minuto de tu plan: la API responde 429 con una cabecera Retry-After si vas más rápido.
Para una importación puntual sin programar, el panel también importa códigos desde un archivo CSV en los planes con importación masiva.
¿Cómo cambio un código ya impreso?
Si incluyes payload, sustituye el contenido completo. Lee primero el código, conserva todos los campos obligatorios y los identificadores de opciones y preguntas. design controla la imagen QR; payload.design controla su página alojada.
Envía PATCH /api/v1/qr-codes/{id} solo con los campos que quieras cambiar, por ejemplo un nuevo payload. El código impreso sigue funcionando y abre el nuevo destino.
Eliminar un código con DELETE /api/v1/qr-codes/{id} hace que dejen de funcionar todas las copias impresas, así que, si dudas, pausa o archiva el código.
¿Dónde está la referencia completa?
GET /api/v1/qr-types enumera los campos y ejemplos actuales: encuestas, formularios, agendas y condiciones de cupones. GET /api/v1/qr-codes/{id}/poll-results devuelve resultados privados. GET /api/v1/qr-codes/{id}/form-responses devuelve respuestas paginadas y origen/UTM; filtra con since y source. Los informes admiten claves de solo lectura. Los envíos y votos no generan webhooks actualmente.
La página para desarrolladores enumera todos los endpoints, y la descripción OpenAPI en https://qrflick.com/developers/openapi.json funciona con la mayoría de herramientas de API y generadores de código.
Preguntas y respuestas
¿Qué planes incluyen la API?
Los planes con acceso a la API (próximamente), que aparecen en la comparativa de precios. Tu plan también fija cuántas peticiones puedes enviar por minuto.
¿Puedo subir mi logo con la API?
Sí. Envía el archivo con POST a /api/v1/uploads/logos y usa el id devuelto como design.logo_upload_id.
¿También puedo crear QR estáticos?
Sí. POST /api/v1/static-qr-codes devuelve la imagen de un QR estático de cualquiera de los 12 tipos sin guardar nada en tu cuenta.
Por QRflick · Revisado por Haroon, cofundador de HS Digital · · Cómo se preparan estas guías
Tu próxima conexión te espera.
Haz que tu próximo escaneo
sea el comienzo de algo.
sea el comienzo de algo.
Tu próximo cliente puede estar buscándote ya. Pónselo fácil.
Crea tu primer QR gratis Sin tarjeta. Sin caducidad. Solo posibilidades.