胸牌、桌卡、货架标签和产品吊牌都需要各自的二维码，手动制作数百个根本不现实。Posty5 的批量导入可以把一个 CSV 文件变成二维码，在创建任何内容之前检查每一行，并生成一个 ZIP，每行一张 PNG 图片，按你的印刷需求命名。
- 打开 Bulk import — 在 Posty5 控制台中打开二维码生成器，然后选择 Bulk import。
- 填写模板 — 下载 CSV 模板，每个二维码填写一行，并把 fileName 设为每张图片所需的名称。
- 上传并检查 — 上传文件，选择默认模板和图片尺寸并进行检查。Posty5 会在创建任何内容之前列出所有失败行。
- 生成二维码 — 开始导入并查看进度，或离开页面等待通知。
- 下载 ZIP — 下载 PNG 图片的 ZIP 和结果文件。
开始之前
你需要一个已登录的 Posty5 账户。在控制台中打开二维码生成器，然后选择 Bulk import。批量生成取决于你的套餐：如果你的套餐不包含此功能，页面会显示为锁定状态。
从页面提供的 CSV 模板开始：它包含表头行和一行示例。
制作 CSV 文件
每一行都可以包含以下列。列名不区分大小写。
type | 二维码承载的内容类型。留空时为 url。 |
name | 供你自己列表使用的名称。 |
customId | 二维码链接的自定义结尾，前提是你的套餐允许自定义结尾。它必须未被使用，包括不能与前面的行重复。 |
tag | 用于日后分组和筛选二维码的标签。 |
refId | 你自己的参考编号，例如产品编号或参会者编号。 |
templateId | 此行的设计模板。它会覆盖你选择的默认值。 |
fileName | 图片在 ZIP 中的名称。留空时使用二维码的名称。 |
然后添加该行类型对应的列：
url | url |
freeText | text |
email | email, subject, body |
wifi | ssid, security, password |
call | phoneNumber |
sms | phoneNumber, message |
geolocation | latitude, longitude, mapUrl |
请将文件保存为带逗号分隔和表头行的 UTF-8 CSV。文件类型的二维码无法批量创建，因为每个文件都需要单独上传。
开始二维码批量导入上传、选择图片尺寸并检查
上传后，选择默认的模板、标签和参考 ID，以及图片尺寸：512、1,024 或 2,000 像素。图片格式为 PNG。然后检查文件：Posty5 会读取每一行但不创建任何内容，并列出每个失败行的行号和原因——该行类型所需的值缺失或无效、某个值过长、自定义结尾已被占用或你的套餐不允许，或模板不属于你。
生成二维码
开始导入。导入在后台运行，并显示已处理、已创建和失败的行数；你可以离开页面，完成时会收到通知。
你可以取消正在运行的导入。取消之前已创建的二维码会保留在你的账户中。
- 单个文件最多 5,000 行、2 MB。
- 每个账户每天（UTC）最多可批量创建 20,000 行，所有导入和 API 调用合并计算。
- 同一时间只运行一个导入，其后最多还可有三个排队等待。
- 如果账户的额度用完，该行及其后所有行都会失败，已创建的二维码会保留。
下载 ZIP 和结果
导入完成后，下载图片 ZIP、结果文件（每行一条记录，含状态和新二维码的详细信息），如有失败行，再下载错误文件，其中保留了你原样填写的那些行。
图片名称会处理为在任何系统中都安全的形式，并截短至 100 个字符。同名的两行会依次加上 -2、-3 等后缀，没有可用字符的名称会变成 qr- 加上行号。
下载链接的有效期为 15 分钟；从过往导入中重新打开该导入即可获取新链接。上传文件和结果文件保留 7 天，导入记录保留 30 天。
导入后的二维码
每一行都是你二维码列表中的一个普通二维码。你可以像手动创建的二维码一样打开、编辑并重新下载它。
在二维码列表中，Export CSV 和 Export JSON 可按列表的筛选条件下载你的二维码，每个文件最多 50,000 行。导出内容中绝不会包含 Wi-Fi 密码。
静态二维码直接承载内容，因此扫描它永远不会经过 Posty5，也不会统计任何扫描次数。只有指向 Posty5 地址的二维码才能统计扫描。
通过代码实现
开发者可以使用 API 密钥，通过 Posty5 API（POST /api/link-bulk-jobs）将同样的 CSV 或 JSON 行作为任务提交，并轮询直到 ZIP 准备就绪。适用相同的检查和限制。这些接口路径记录在 API 参考文档中。
常见问题
一次可以生成多少个二维码？
单个文件最多 5,000 行、2 MB，每个账户每天最多可批量创建 20,000 行。
哪些二维码类型支持批量生成？
网址、自由文本、电子邮件、Wi-Fi、电话、短信（SMS）和地理位置。文件类二维码无法批量创建。
批量生成的二维码可以编辑吗？
可以。每一行都会成为你列表中的普通二维码，可以打开、编辑并重新下载。
我能看到这些二维码的扫描数据吗？
只有指向 Posty5 地址的二维码才可以。静态二维码直接承载内容，其扫描永远不会到达 Posty5。
ZIP 可以下载多久？
每个下载链接的有效期为 15 分钟，文件保留 7 天；重新打开该导入即可获取新链接。
