Saltar al contenido
QRflick

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.

Un público reunido en una sala de conferencias para una presentación.
Vista ilustrativaQRflick

Respuesta rápida

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.

Una 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.

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. 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. 2 Envía tu primera peticiónHaz POST a /api/v1/qr-codes con tu clave en la cabecera Authorization.
  3. 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. 4 Descarga e imprimeObtén el archivo de impresión de cada código en /api/v1/qr-codes/{id}/image.

Explora los detalles

¿Cómo es una petición de creación?

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?

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?

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, 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 · 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.

Tu próximo cliente puede estar buscándote ya. Pónselo fácil.

Crea tu primer QR gratis Sin tarjeta. Sin caducidad. Solo posibilidades.