当活动表格或产品目录有数百行时，逐个创建短链接就不再现实。Posty5 的批量导入接收一个 CSV 文件，在创建任何内容之前检查每一行，在后台创建链接，并提供一个结果文件，把每个短地址与其来源行一一对应。

1. 打开 Bulk import — 在 Posty5 控制台中打开网址缩短工具，然后选择 Bulk import。
2. 填写模板 — 下载 CSV 模板，每个目标 URL 填写一行；只有 url 列是必填的。
3. 上传并检查 — 上传文件，为空列选择默认值并进行检查。Posty5 会在创建任何内容之前列出所有失败行。
4. 运行导入 — 开始导入并查看进度，或离开页面等待通知。
5. 下载结果 — 下载包含每个短地址的结果文件；如有失败行，再下载错误文件。

开始之前

你需要一个已登录的 Posty5 账户。在控制台中打开网址缩短工具，然后选择 Bulk import。批量创建取决于你的套餐：如果你的套餐不包含此功能，页面会显示为锁定状态。

从页面提供的 CSV 模板开始。它已包含正确的表头行和一行示例，你只需把示例替换成自己的数据。

准备 CSV 文件

只有 url 列是必填的。列名不区分大小写，Posty5 不认识的列会被忽略，并在检查步骤中列出。

请将文件保存为带逗号分隔和表头行的 UTF-8 CSV。包含逗号的值需放在双引号中，电子表格应用在导出 CSV 时会自动处理。

上传并检查文件

上传后，为留空某一列的行选择默认值（模板、标签和参考 ID），然后检查文件。Posty5 会读取每一行但不创建任何内容，并列出每个失败行及其行号，行号从表头下方的第一行开始计算。出现以下情况时该行失败：

• URL 缺失、不是有效的网址，或超过 2,048 个字符
• URL 因不安全而被拦截，与单个链接的处理方式完全相同
• 名称、标签或参考编号超过 255 个字符
• 自定义结尾在你的套餐中不允许、无效或已被使用
• 模板不存在或不属于你

运行导入

检查结果没问题后即可开始导入。导入在后台运行：页面会显示已处理、已创建和失败的行数，你也可以离开页面——导入完成时会收到通知。

你可以取消正在运行的导入。取消之前已创建的链接会保留在你的账户中。

页面标题和应用深层链接会在每个链接创建后再获取，因此新链接可能会在短时间内以主机名作为名称显示。

• 单个文件最多 5,000 行、2 MB。
• 每个账户每天（UTC）最多可批量创建 20,000 行，所有导入和 API 调用合并计算。
• 同一时间只运行一个导入，其后最多还可有三个排队等待。
• 如果导入过程中账户的额度用完，该行及其后所有行都会失败，已创建的链接会保留。

下载结果

导入完成后，下载结果文件。文件中你的每一行对应一行记录：行号、状态（已创建、失败、已跳过，或在导入到达该行前就停止时为未处理）、新链接的 ID 和短地址，以及失败行的原因。

另一个文件只包含失败的行及其原始值，方便你修正后重新上传该文件。

过往的导入会连同状态和计数一起列出，你可以稍后打开任意一次导入并再次下载其文件。上传文件和结果文件保留 7 天，导入记录保留 30 天——请在此之前下载所需内容。链接本身永远不会被删除。

之后导出你的链接

• 在短链接列表中选择 Export CSV 或 Export JSON，即可下载链接及其访问计数。
• 导出会遵循列表当前应用的筛选条件，所以想导出单个活动时，先按标签筛选即可。
• 单次导出最多 50,000 行，按从新到旧排列；更长的列表会在此处截断，文件中会注明。
• 以 =、+、- 或 @ 开头的 CSV 单元格会被加上前导撇号，这样电子表格应用会把它显示为文本，而不是当作公式执行。

通过代码实现

开发者可以使用 API 密钥通过 Posty5 API 完成同样的操作：POST /api/short-link/bulk 在一次请求中最多创建 100 行，并为每行返回一个结果；POST /api/link-bulk-jobs 则把整个文件作为任务提交，你可以轮询其状态。两者使用与控制台相同的检查和限制。这些接口路径记录在 API 参考文档中。

常见问题

相关指南

• 阅读： Posty5 URL Shortener：创建和管理短链接
• 阅读： 如何使用 Tag 和 Ref ID 整理活动链接
• 阅读： 如何从 CSV 文件批量生成二维码
• 阅读： Posty5 API 密钥与 SDK：开发者指南
• 阅读： guide.posty5.com