> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Générer des codes QR en masse
> POST /bulk-operation/generate/
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
```
Un libellé pour cette opération, affiché dans [Lister les opérations en masse](/fr/api-reference/management-api/bulk-operation/list).
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.
Un id de domaine personnalisé à utiliser pour les liens courts des codes QR générés.
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.
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).
Un id de dossier dans lequel enregistrer les codes QR générés.
```bash cURL theme={null}
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"}'
```
```json 200 theme={null}
{
"operation_id": "bo-8f3a1c",
"message": ["Your file is being processed. We'll email you once it's ready."]
}
```
## Ceci est asynchrone
La réponse `200` 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](/fr/api-reference/management-api/bulk-operation/list) (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)](/fr/api-reference/management-api/bulk-operation/generate-v2) — l'équivalent pour les modèles v2.
* [Valider un fichier d'opération en masse](/fr/api-reference/management-api/bulk-operation/validate) — vérifier le fichier avant de consommer cet appel.
* [Télécharger un fichier d'exemple](/fr/api-reference/management-api/bulk-operation/sample-file) — d'où partir pour la feuille.
* [Lister les opérations en masse](/fr/api-reference/management-api/bulk-operation/list) — attendre l'achèvement.
* [Présentation de l'API de gestion](/fr/api-reference/management-api/overview) — le schéma d'authentification et les règles de quota applicables à cet endpoint.
## OpenAPI
````yaml api-reference/openapi/management-api.json POST /bulk-operation/generate/
openapi: 3.1.0
info:
title: Scanova Management API (v2)
description: >-
The complete Scanova Management API — every endpoint available at
api.scanova.io (QR codes, folders, tags, leads, forms, analytics, plans,
shared users & roles), plus the token-creation and usage-stats endpoints
used to authenticate against it. Every path and request/response shape below
was verified live against a real API key and the actual running backend
(Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
version: 2.0.0
servers:
- url: https://api.scanova.io
description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
- apiKeyAuth: []
paths:
/bulk-operation/generate/:
post:
summary: Bulk-generate QR codes
description: >-
Creates many QR codes from an uploaded sheet, asynchronously. Returns
immediately with an `operation_id` while a Celery task does the work —
poll [List bulk
operations](/api-reference/management-api/bulk-operation/list) for
`status`/`progress`, then fetch `result_file`/`log_file` once complete.
The sheet's first row's `qr code id` supplies the template QR whose
category and field schema every other row is validated against.
operationId: generateBulkOperation
requestBody:
content:
multipart/form-data:
example:
name: September event QR batch
file: (binary file)
custom_domain: null
pattern_info: '{"dotStyle":"round"}'
folder: null
auto_deactivate:
expire_on: '2026-12-31T23:59:59Z'
responses:
'200':
description: Generation started.
content:
application/json:
example:
operation_id: bo-8f3a1c
message:
- >-
Your file is being processed. We'll email you once it's
ready.
'400':
description: >-
Invalid file/columns, missing or invalid template QR, or quota
exceeded.
'403':
description: >-
Missing BULK_OPERATION quota, inactive plan, or missing
BULK_OPERATION_CAN_GENERATE permission.
components:
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: Authorization
description: >-
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.
````