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."]
}
批量操作
批量生成 QR 码
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."]
}
在 Management API 主机（
api.scanova.io）上根据上传的表格异步创建大量 QR 码，使用您的原始 Management API 密钥进行身份验证。
POST https://api.scanova.io/bulk-operation/generate/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
file
必填
填写好的表格，每个 QR 码一行。第一行的
qr code id 列提供模板 QR——其分类和字段模式是其他每一行据以验证的标准。integer
用于生成的 QR 码短链接的自定义域名 id。
string
应用于所有生成的 QR 码的设计图案数据，通常以 JSON 字符串编码。
object
应用于所有生成的 QR 码的可选自动停用规则：
expire_on/activate_on（未来的 ISO-8601 时间）和/或 expire_on_scan_count（正整数）。integer
用于保存生成的 QR 码的文件夹 id。
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."]
}
这是异步操作
200 响应确认作业已被接受，而非 QR 码已经存在——实际工作在后台工作进程中运行。轮询列出批量操作（在本地按 operation_id 过滤），关注 status（new → completed/partially_completed/failed）和 progress，完成后再读取 result_file/log_file。账户在完成后也会收到邮件通知。
如果文件/列无效、模板 QR 缺失或无效，或配额（BULK_OPERATION 或 TOTAL_QR_CODES）超出，则返回 400。如果账户缺少 BULK_OPERATION 配额、套餐不活跃，或缺少 BULK_OPERATION_CAN_GENERATE 权限，则返回 403。
相关内容
- 批量生成 QR 码（v2 模板）——适用于 v2 模板的等效端点。
- 验证批量操作文件——在消耗此调用之前检查文件。
- 下载示例文件——从何处开始填写表格。
- 列出批量操作——轮询完成状态。
- Management API 概览——适用于此端点的身份验证方案和配额规则。
授权
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.
响应
Generation started.
此页面对您有帮助吗？