Documentazione API

Operazioni in blocco

Creazione in blocco di Codici QR

Automatizza la creazione dei tuoi codici QR con la nostra API. Crea centinaia o migliaia di codici QR in una volta, perfetti per grandi campagne, etichettatura di prodotti o tracciamento di beni.

Importazione CSV

Carica un file CSV con i tuoi dati sui codici QR e li creeremo tutti in una volta.

Batch API

Crea più codici QR in una singola chiamata API con payload JSON.

Elaborazione asincrona

Importazioni di grandi dimensioni vengono eseguite in background con tracciamento dello stato.

Endpoint

Metodo	Endpoint	Descrizione
POST	/organizations/:orgId/qr-codes/bulk-import	Avvia un'importazione in blocco da CSV
GET	/organizations/:orgId/qr-codes/bulk-import	Elenca tutti i lavori di importazione
GET	/organizations/:orgId/qr-codes/bulk-import/:id	Ottieni lo stato del lavoro di importazione
GET	/organizations/:orgId/qr-codes/bulk-import/sample	Scarica il modello CSV
POST	/organizations/:orgId/qr-codes/batch/update	Aggiorna in blocco più codici QR
POST	/organizations/:orgId/qr-codes/batch/clone	Clona più codici QR
DELETE	/organizations/:orgId/qr-codes/batch	Elimina più codici QR

Importazione in blocco CSV

Il modo più semplice per creare molti codici QR contemporaneamente è tramite importazione CSV. Segui questi passaggi:

Scarica il modello CSV

Ottieni il modello per il tuo tipo di codice QR per garantire una formattazione corretta.

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

Compila i tuoi dati

Aggiungi i tuoi dati del codice QR al file CSV. Ecco un esempio per i codici QR 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

Carica il file CSV

Invia il file per avviare il lavoro di importazione.

Avvia Importazione

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"

Monitora il progresso dell'importazione

Controlla lo stato del tuo lavoro di importazione.

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"

Risposta

{
  "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"
}

Riferimento Colonna CSV

Ogni tipo di codice QR richiede colonne diverse. Ecco le più comuni:

Codici QR URL

Colonna	Obbligatoria	Descrizione
name	Obbligatoria	Nome visualizzato per il codice QR
url	Obbligatoria	URL di destinazione (deve iniziare con http:// o https://)
folder	Facoltativa	Nome della cartella per organizzare il codice QR
tags	Facoltativa	Tag separati da punti e virgola

Codici QR vCard

Colonna	Obbligatoria	Descrizione
name	Obbligatoria	Nome visualizzato per il codice QR
firstName	Obbligatoria	Nome di battesimo del contatto
lastName	Obbligatoria	Cognome del contatto
email	Facoltativa	Indirizzo email
phone	Facoltativa	Numero di telefono
company	Facoltativa	Nome dell'azienda
title	Facoltativa	Titolo di lavoro

Aggiornamento in blocco

Aggiorna più codici QR contemporaneamente con una singola chiamata API.

POST

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

Richiesta di aggiornamento in blocco

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"
      }
    }
  }'

Limiti di importazione

Righe massime

10,000

Codici QR per file CSV

Limite dimensione file

10 MB

Dimensione massima del file CSV

Consiglio: Per importazioni molto grandi (10.000+ codici QR), considera di suddividere il tuo CSV in più file e importarli in sequenza.

Casi d'uso

Etichettatura dei prodotti

Genera codici QR unici per ogni prodotto nel tuo inventario

Campagne di marketing

Crea codici QR personalizzati per ogni destinatario

Tracciamento degli asset

Etichetta attrezzature, documenti o beni fisici

Gestione eventi

Genera biglietti o badge con codici QR unici

Prossimi passi

Scopri le funzionalità correlate: