curl -X POST "https://api.scanova.io/bulk-operation/generate/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-F "name=September event QR batch" \
-F "file=@event-qrs.xlsx" \
-F 'auto_deactivate={"expire_on":"2026-12-31T23:59:59Z"}'
{
"operation_id": "bo-8f3a1c",
"message": ["Your file is being processed. We'll email you once it's ready."]
}
Massenvorgänge
QR-Codes in großer Menge erstellen
POST /bulk-operation/generate/
POST
/
bulk-operation
/
generate
/
curl -X POST "https://api.scanova.io/bulk-operation/generate/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-F "name=September event QR batch" \
-F "file=@event-qrs.xlsx" \
-F 'auto_deactivate={"expire_on":"2026-12-31T23:59:59Z"}'
{
"operation_id": "bo-8f3a1c",
"message": ["Your file is being processed. We'll email you once it's ready."]
}
Erstellt viele QR-Codes asynchron aus einer hochgeladenen Tabelle, auf dem Management-API-Host (
api.scanova.io), authentifiziert mit Ihrem rohen Management-API-Schlüssel.
POST https://api.scanova.io/bulk-operation/generate/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
erforderlich
Eine Bezeichnung für diesen Vorgang, angezeigt in Massenvorgänge auflisten.
file
erforderlich
Die ausgefüllte Tabelle, eine Zeile pro QR-Code. Die Spalte
qr code id der ersten Zeile liefert den Vorlagen-QR-Code — dessen Kategorie und Feldschema sind das, wogegen jede andere Zeile validiert wird.integer
Eine Domain-ID für benutzerdefinierte Domains, die für die Kurzlinks der erstellten QR-Codes verwendet wird.
string
Design-Musterdaten, die auf alle erstellten QR-Codes angewendet werden, typischerweise als JSON-String kodiert.
object
Optionale Regel zur automatischen Deaktivierung, die auf alle erstellten QR-Codes angewendet wird:
expire_on/activate_on (zukünftige ISO-8601-Zeitstempel) und/oder expire_on_scan_count (positive Ganzzahl).integer
Eine Ordner-ID, in der die erstellten QR-Codes gespeichert werden.
curl -X POST "https://api.scanova.io/bulk-operation/generate/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-F "name=September event QR batch" \
-F "file=@event-qrs.xlsx" \
-F 'auto_deactivate={"expire_on":"2026-12-31T23:59:59Z"}'
{
"operation_id": "bo-8f3a1c",
"message": ["Your file is being processed. We'll email you once it's ready."]
}
Dies ist asynchron
Die200-Antwort bestätigt, dass der Auftrag angenommen wurde, nicht dass die QR-Codes bereits existieren — die eigentliche Arbeit läuft auf einem Hintergrund-Worker. Fragen Sie Massenvorgänge auflisten ab (lokal nach operation_id gefiltert) und beobachten Sie status (new → completed/partially_completed/failed) und progress, lesen Sie dann result_file/log_file, sobald abgeschlossen. Das Konto erhält bei Abschluss außerdem eine E-Mail-Benachrichtigung.
400 bei einer ungültigen Datei/Spalten, einem fehlenden oder ungültigen Vorlagen-QR-Code, oder überschrittener Quota (BULK_OPERATION oder TOTAL_QR_CODES). 403, wenn dem Konto die Quota BULK_OPERATION fehlt, der Plan inaktiv ist, oder die Berechtigung BULK_OPERATION_CAN_GENERATE fehlt.
Verwandte Themen
- QR-Codes in großer Menge erstellen (v2-Vorlagen) — das Äquivalent für v2-Vorlagen.
- Massenvorgangs-Datei validieren — die Datei vor diesem Aufruf prüfen.
- Beispieldatei herunterladen — womit die Tabelle begonnen werden sollte.
- Massenvorgänge auflisten — auf den Abschluss warten.
- Übersicht über die Management API — das Authentifizierungsschema und die Quota-Regeln für diesen Endpunkt.
Autorisierungen
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Antwort
Generation started.
War diese Seite hilfreich?