Documentation API

Opérations en masse

Création en masse de codes QR

Automatisez la création de vos codes QR avec notre API. Créez des centaines ou des milliers de codes QR à la fois, parfait pour de grandes campagnes, l'étiquetage de produits ou le suivi d'actifs.

Importation CSV

Téléchargez un fichier CSV avec vos données de code QR et nous les créerons tous en une seule fois.

API Batch

Créez plusieurs codes QR en un seul appel API avec une charge utile JSON.

Traitement asynchrone

Les grandes importations s'exécutent en arrière-plan avec suivi de l'état.

Points de terminaison

Méthode	Point de terminaison	Description
POST	/organizations/:orgId/qr-codes/bulk-import	Démarrer une importation en masse à partir de CSV
GET	/organizations/:orgId/qr-codes/bulk-import	Lister tous les travaux d'importation
GET	/organizations/:orgId/qr-codes/bulk-import/:id	Obtenir l'état du travail d'importation
GET	/organizations/:orgId/qr-codes/bulk-import/sample	Télécharger le modèle CSV
POST	/organizations/:orgId/qr-codes/batch/update	Mettre à jour plusieurs codes QR en lot
POST	/organizations/:orgId/qr-codes/batch/clone	Cloner plusieurs codes QR
DELETE	/organizations/:orgId/qr-codes/batch	Supprimer plusieurs codes QR

Importation en masse CSV

Le moyen le plus simple de créer de nombreux codes QR à la fois est via l'importation CSV. Suivez ces étapes :

Téléchargez le modèle CSV

Obtenez le modèle pour votre type de code QR afin d'assurer un formatage correct.

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

Remplissez vos données

Ajoutez vos données de code QR au fichier CSV. Voici un exemple pour les codes 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

Téléchargez le fichier CSV

Envoyez le fichier pour démarrer le travail d'importation.

Démarrer l'importation

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"

Surveiller l'avancement de l'importation

Vérifiez l'état de votre travail d'importation.

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"

Réponse

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

Référence de colonne CSV

Chaque type de code QR nécessite des colonnes différentes. Voici les plus courantes :

Codes QR URL

Colonne	Requis	Description
name	Requis	Nom d'affichage pour le code QR
url	Requis	URL de destination (doit commencer par http:// ou https://)
folder	Optionnel	Nom de dossier pour organiser le code QR
tags	Optionnel	Tags séparés par des points-virgules

Codes QR vCard

Colonne	Requis	Description
name	Requis	Nom d'affichage pour le code QR
firstName	Requis	Prénom du contact
lastName	Requis	Nom de famille du contact
email	Optionnel	Adresse e-mail
phone	Optionnel	Numéro de téléphone
company	Optionnel	Nom de l'entreprise
title	Optionnel	Titre du poste

Mise à jour en lot

Mettez à jour plusieurs codes QR à la fois avec un seul appel API.

POST

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

Demande de mise à jour en lot

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

Limites d'importation

Lignes maximales

10,000

codes QR par fichier CSV

Limite de taille de fichier

10 MB

Taille maximale du fichier CSV

Conseil : Pour des importations très volumineuses (10 000+ QR codes), envisagez de diviser votre CSV en plusieurs fichiers et de les importer séquentiellement.

Cas d'utilisation

Étiquetage de produit

Générez des QR codes uniques pour chaque produit de votre inventaire

Campagnes marketing

Créez des QR codes personnalisés pour chaque destinataire

Suivi des actifs

Étiquetez l'équipement, les documents ou les actifs physiques

Gestion d'événements

Générez des billets ou des badges avec des QR codes uniques

Prochaines étapes

Découvrez les fonctionnalités associées :