curl -X POST "https://api.scanova.io/bulk-operation/gs1/serial-range-generate/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"name": "GS1 batch 001-100",
"start_serial": "00000001",
"count": 100,
"sample_qrid": "a1b2c3d4"
}'
{
"operation_id": "bo-gs1-001",
"message": ["Your GS1 serial range is being processed. We'll email you once it's ready."]
}
批量操作
批量生成 GS1 序列号区间
POST /bulk-operation/gs1/serial-range-generate/
POST
/
bulk-operation
/
gs1
/
serial-range-generate
/
curl -X POST "https://api.scanova.io/bulk-operation/gs1/serial-range-generate/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"name": "GS1 batch 001-100",
"start_serial": "00000001",
"count": 100,
"sample_qrid": "a1b2c3d4"
}'
{
"operation_id": "bo-gs1-001",
"message": ["Your GS1 serial range is being processed. We'll email you once it's ready."]
}
在 Management API 主机（
与批量生成 QR 码相同的异步模式——轮询列出批量操作。在创建任何 QR 码之前，会对该区间中第一个组装好的 GS1 数据进行模式验证，因此格式错误的
api.scanova.io）上根据起始序列号异步生成一段连续的 GS1 QR 码区间，使用您的原始 Management API 密钥进行身份验证。
POST https://api.scanova.io/bulk-operation/gs1/serial-range-generate/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
无需上传文件——此端点根据
start_serial 和 count 以编程方式生成该区间。string
必填
此操作的标签。
string
必填
区间中的第一个序列号，仅限数字，最多 20 个字符。
integer
必填
要生成的连续序列号数量，最少为 1。
string
现有 GS1 QR 的 id，用于从中复制共享字段值。请提供此项或
shared_info，二者不可都不提供。array
区间内每个序列号共享的 GS1 字段值，以 JSON 形式提供。请提供此项或
sample_qrid，二者不可都不提供。integer
用于生成的 QR 码短链接的自定义域名 id。
string
应用于所有生成的 QR 码的设计图案数据。
object
应用于所有生成的 QR 码的可选自动停用规则。
object
应用于所有生成的 QR 码链接的 UTM 跟踪参数。
integer
用于保存生成的 QR 码的文件夹 id。
curl -X POST "https://api.scanova.io/bulk-operation/gs1/serial-range-generate/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"name": "GS1 batch 001-100",
"start_serial": "00000001",
"count": 100,
"sample_qrid": "a1b2c3d4"
}'
{
"operation_id": "bo-gs1-001",
"message": ["Your GS1 serial range is being processed. We'll email you once it's ready."]
}
shared_info 会快速失败。
如果区间中的序列号在任何位置超过 20 个字符、既未提供 shared_info 也未提供 sample_qrid，或配额（BULK_OPERATION 或 TOTAL_QR_CODES，按完整的 count 检查）超出，则返回 400。如果账户缺少 BULK_OPERATION 配额、套餐不活跃，或缺少 BULK_OPERATION_CAN_GENERATE 权限，则返回 403。
相关内容
- 批量生成 QR 码——适用于非 GS1 分类的基于文件的通用等效端点。
- 列出批量操作——轮询完成状态。
- 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.
此页面对您有帮助吗？