Documentación de API

Operaciones masivas

Creación masiva de códigos QR

Automatiza la creación de tus códigos QR con nuestra API. Crea cientos o miles de códigos QR a la vez, perfecto para grandes campañas, etiquetado de productos o seguimiento de activos.

Importación CSV

Sube un archivo CSV con los datos de tus códigos QR y los crearemos todos a la vez.

Lote API

Crea múltiples códigos QR en una sola llamada API con carga JSON.

Procesamiento asíncrono

Las importaciones grandes se ejecutan en segundo plano con seguimiento de estado.

Puntos finales

Método	Punto final	Descripción
POST	/organizations/:orgId/qr-codes/bulk-import	Iniciar una importación masiva desde CSV
GET	/organizations/:orgId/qr-codes/bulk-import	Listar todos los trabajos de importación
GET	/organizations/:orgId/qr-codes/bulk-import/:id	Obtener estado del trabajo de importación
GET	/organizations/:orgId/qr-codes/bulk-import/sample	Descargar plantilla CSV
POST	/organizations/:orgId/qr-codes/batch/update	Actualizar múltiples códigos QR en lote
POST	/organizations/:orgId/qr-codes/batch/clone	Clonar múltiples códigos QR
DELETE	/organizations/:orgId/qr-codes/batch	Eliminar múltiples códigos QR

Importación masiva CSV

La forma más fácil de crear muchos códigos QR a la vez es mediante importación CSV. Sigue estos pasos:

Descargar la plantilla CSV

Obtén la plantilla para tu tipo de código QR para asegurar un formato adecuado.

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import/sample?type=URL" \
  -H "X-API-Key: YOUR_API_KEY" \
  -o template.csv

Completa tus datos

Agrega tus datos de código QR al archivo CSV. Aquí hay un ejemplo para códigos QR de URL:

url_qr_codes.csv

name,url,folder,tags
Homepage QR,https://example.com,Marketing,homepage;main
Product Page,https://example.com/product,Products,product;featured
Contact Us,https://example.com/contact,Marketing,contact;support
Promo Landing,https://example.com/promo,Campaigns,promo;summer2024

Sube el archivo CSV

Envía el archivo para iniciar el trabajo de importación.

Iniciar importación

curl -X POST \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@url_qr_codes.csv" \
  -F "type=URL"

Monitorea el progreso de la importación

Verifica el estado de tu trabajo de importación.

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import/import_abc123" \
  -H "X-API-Key: YOUR_API_KEY"

Respuesta

{
  "id": "import_abc123",
  "status": "COMPLETED",
  "type": "URL",
  "totalRows": 100,
  "processedRows": 100,
  "successCount": 98,
  "errorCount": 2,
  "errors": [
    { "row": 45, "error": "Invalid URL format" },
    { "row": 72, "error": "Name is required" }
  ],
  "createdAt": "2024-01-15T10:00:00Z",
  "completedAt": "2024-01-15T10:02:30Z"
}

Referencia de columna CSV

Cada tipo de código QR requiere diferentes columnas. Aquí están las más comunes:

Códigos QR de URL

Columna	Requerido	Descripción
name	Requerido	Nombre para mostrar del código QR
url	Requerido	URL de destino (debe comenzar con http:// o https://)
folder	Opcional	Nombre de la carpeta para organizar el código QR
tags	Opcional	Etiquetas separadas por punto y coma

Códigos QR vCard

Columna	Requerido	Descripción
name	Requerido	Nombre para mostrar del código QR
firstName	Requerido	Nombre de pila del contacto
lastName	Requerido	Apellido del contacto
email	Opcional	Dirección de correo electrónico
phone	Opcional	Número de teléfono
company	Opcional	Nombre de la empresa
title	Opcional	Título del trabajo

Actualización en lote

Actualiza múltiples códigos QR a la vez con una sola llamada API.

POST

/organizations/:orgId/qr-codes/batch/update

Solicitud de actualización en lote

curl -X POST \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/batch/update" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": ["qr_abc123", "qr_def456", "qr_ghi789"],
    "updates": {
      "folderId": "folder_xyz",
      "style": {
        "foregroundColor": "#1D59F9"
      }
    }
  }'

Límites de importación

Filas máximas

10,000

Códigos QR por archivo CSV

Límite de tamaño de archivo

10 MB

Tamaño máximo del archivo CSV

Consejo: Para importaciones muy grandes (10,000+ códigos QR), considera dividir tu CSV en múltiples archivos e importarlos secuencialmente.

Casos de uso

Etiquetado de productos

Genera códigos QR únicos para cada producto en tu inventario

Campañas de marketing

Crea códigos QR personalizados para cada destinatario

Seguimiento de activos

Etiqueta equipos, documentos o activos físicos

Gestión de eventos

Genera boletos o credenciales con códigos QR únicos

Próximos pasos

Conoce las funciones relacionadas: