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."]
}
Opérations en masse
Générer des codes QR en masse
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."]
}
Crée de nombreux codes QR à partir d’une feuille téléversée, de manière asynchrone, sur l’hôte de l’API de gestion (
api.scanova.io), authentifié avec votre clé d’API de gestion brute.
POST https://api.scanova.io/bulk-operation/generate/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
requis
Un libellé pour cette opération, affiché dans Lister les opérations en masse.
file
requis
La feuille remplie, une ligne par code QR. La colonne
qr code id de la première ligne fournit le QR modèle — sa catégorie et son schéma de champs sont ce contre quoi chaque autre ligne est validée.integer
Un id de domaine personnalisé à utiliser pour les liens courts des codes QR générés.
string
Données de motif de design appliquées à tous les codes QR générés, généralement encodées sous forme de chaîne JSON.
object
Règle facultative de désactivation automatique appliquée à tous les codes QR générés :
expire_on/activate_on (dates-heures futures au format ISO-8601) et/ou expire_on_scan_count (entier positif).integer
Un id de dossier dans lequel enregistrer les codes QR générés.
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."]
}
Ceci est asynchrone
La réponse200 confirme que la tâche a été acceptée, pas que les codes QR existent déjà — le travail réel s’exécute sur un worker en arrière-plan. Interrogez Lister les opérations en masse (filtré localement par operation_id) et surveillez status (new → completed/partially_completed/failed) et progress, puis lisez result_file/log_file une fois terminé. Le compte reçoit également une notification par e-mail à l’achèvement.
400 pour un fichier/des colonnes invalides, un QR modèle manquant ou invalide, ou un quota dépassé (BULK_OPERATION ou TOTAL_QR_CODES). 403 si le compte n’a pas le quota BULK_OPERATION, a un plan inactif, ou n’a pas la permission BULK_OPERATION_CAN_GENERATE.
Voir aussi
- Générer des codes QR en masse (modèles v2) — l’équivalent pour les modèles v2.
- Valider un fichier d’opération en masse — vérifier le fichier avant de consommer cet appel.
- Télécharger un fichier d’exemple — d’où partir pour la feuille.
- Lister les opérations en masse — attendre l’achèvement.
- Présentation de l’API de gestion — le schéma d’authentification et les règles de quota applicables à cet endpoint.
Autorisations
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.
Réponse
Generation started.
Cette page vous a-t-elle été utile ?