API-Dokumentation

Massenoperationen

Massen QR-Codes erstellen

Automatisieren Sie die Erstellung Ihrer QR-Codes mit unserer API. Erstellen Sie Hunderte oder Tausende von QR-Codes auf einmal, perfekt für große Kampagnen, Produktkennzeichnung oder Asset-Tracking.

CSV-Import

Laden Sie eine CSV-Datei mit Ihren QR-Code-Daten hoch und wir erstellen sie alle auf einmal.

API-Batch

Erstellen Sie mehrere QR-Codes in einem einzigen API-Aufruf mit JSON-Nutzlast.

Asynchrone Verarbeitung

Große Importe laufen im Hintergrund mit Statusverfolgung.

Endpunkte

Methode	Endpunkt	Beschreibung
POST	/organizations/:orgId/qr-codes/bulk-import	Starten Sie einen Massenimport von CSV
GET	/organizations/:orgId/qr-codes/bulk-import	Listen Sie alle Importjobs auf
GET	/organizations/:orgId/qr-codes/bulk-import/:id	Holen Sie sich den Status des Importjobs
GET	/organizations/:orgId/qr-codes/bulk-import/sample	CSV-Vorlage herunterladen
POST	/organizations/:orgId/qr-codes/batch/update	Batch-Aktualisierung mehrerer QR-Codes
POST	/organizations/:orgId/qr-codes/batch/clone	Klonen Sie mehrere QR-Codes
DELETE	/organizations/:orgId/qr-codes/batch	Löschen Sie mehrere QR-Codes

CSV-Massenimport

Der einfachste Weg, viele QR-Codes auf einmal zu erstellen, ist der CSV-Import. Befolgen Sie diese Schritte:

Laden Sie die CSV-Vorlage herunter

Holen Sie sich die Vorlage für Ihren QR-Code-Typ, um das richtige Format sicherzustellen.

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

Füllen Sie Ihre Daten aus

Fügen Sie Ihre QR-Code-Daten in die CSV-Datei ein. Hier ist ein Beispiel für URL-QR-Codes:

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

Laden Sie die CSV-Datei hoch

Senden Sie die Datei, um den Importjob zu starten.

Import starten

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"

Überwachen Sie den Importfortschritt

Überprüfen Sie den Status Ihres Importjobs.

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"

Antwort

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

CSV-Spaltenreferenz

Jeder QR-Code-Typ benötigt unterschiedliche Spalten. Hier sind die häufigsten:

URL-QR-Codes

Spalte	Erforderlich	Beschreibung
name	Erforderlich	Anzeigename für den QR-Code
url	Erforderlich	Ziel-URL (muss mit http:// oder https:// beginnen)
folder	Optional	Ordnername zur Organisation des QR-Codes
tags	Optional	Tags, die durch Semikolons getrennt sind

vCard-QR-Codes

Spalte	Erforderlich	Beschreibung
name	Erforderlich	Anzeigename für den QR-Code
firstName	Erforderlich	Vorname des Kontakts
lastName	Erforderlich	Nachname des Kontakts
email	Optional	E-Mail-Adresse
phone	Optional	Telefonnummer
company	Optional	Firmenname
title	Optional	Berufsbezeichnung

Batch-Aktualisierung

Aktualisieren Sie mehrere QR-Codes auf einmal mit einem einzigen API-Aufruf.

POST

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

Batch-Aktualisierungsanfrage

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

Importgrenzen

Maximale Zeilen

10,000

QR-Codes pro CSV-Datei

Dateigrößenlimit

10 MB

Maximale CSV-Dateigröße

Tip: Für sehr große Importe (10.000+ QR-Codes) sollten Sie in Betracht ziehen, Ihre CSV in mehrere Dateien aufzuteilen und diese nacheinander zu importieren.

Anwendungsfälle

Produktkennzeichnung

Generieren Sie einzigartige QR-Codes für jedes Produkt in Ihrem Inventar

Marketingkampagnen

Erstellen Sie personalisierte QR-Codes für jeden Empfänger

Asset-Tracking

Kennzeichnen Sie Geräte, Dokumente oder physische Vermögenswerte

Veranstaltungsmanagement

Generieren Sie Tickets oder Ausweise mit einzigartigen QR-Codes

Nächste Schritte

Erfahren Sie mehr über verwandte Funktionen: