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."]
}
Operaciones en masa
Generar códigos QR en masa
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."]
}
Crea muchos códigos QR a partir de una hoja subida, de forma asíncrona, en el host de la API de gestión (
api.scanova.io), autenticado con su clave de API de gestión sin procesar.
POST https://api.scanova.io/bulk-operation/generate/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
requerido
Una etiqueta para esta operación, mostrada en Listar operaciones en masa.
file
requerido
La hoja rellenada, una fila por código QR. La columna
qr code id de la primera fila proporciona el QR plantilla — su categoría y esquema de campos son contra lo que se valida cada una de las demás filas.integer
Un id de dominio personalizado para usar en los enlaces cortos de los códigos QR generados.
string
Datos del patrón de diseño aplicados a todos los códigos QR generados, normalmente codificados como una cadena JSON.
object
Regla opcional de desactivación automática aplicada a todos los códigos QR generados:
expire_on/activate_on (fechas y horas futuras en ISO-8601) y/o expire_on_scan_count (entero positivo).integer
Un id de carpeta donde guardar los códigos QR generados.
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."]
}
Esto es asíncrono
La respuesta200 confirma que el trabajo fue aceptado, no que los códigos QR ya existan — el trabajo real se ejecuta en un proceso en segundo plano. Consulte Listar operaciones en masa (filtrando localmente por operation_id) y observe status (new → completed/partially_completed/failed) y progress, luego lea result_file/log_file una vez finalizado. La cuenta también recibe una notificación por correo al completarse.
400 por un archivo/columnas inválidos, un QR plantilla faltante o inválido, o cuota superada (BULK_OPERATION o TOTAL_QR_CODES). 403 si a la cuenta le falta la cuota BULK_OPERATION, tiene un plan inactivo, o carece del permiso BULK_OPERATION_CAN_GENERATE.
Relacionado
- Generar códigos QR en masa (plantillas v2) — el equivalente para plantillas v2.
- Validar un archivo de operación en masa — comprobar el archivo antes de gastar esta llamada.
- Descargar un archivo de ejemplo — desde dónde comenzar la hoja.
- Listar operaciones en masa — esperar la finalización.
- Resumen de la API de gestión — el esquema de autenticación y las reglas de cuota aplicables a este endpoint.
Autorizaciones
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.
Respuesta
Generation started.
¿Esta página le ayudó?