跳转到内容

批量导入和导出短链接

当您需要缩短几十甚至几千个 URL 时,可以将它们放在一个 CSV 文件中上传,而不必逐个手动创建。每一行都会成为一个普通短链接,您可以像其他链接一样编辑、分享和跟踪。

  1. 在控制台中打开网址缩短器,然后选择批量导入。

  2. 下载 CSV 模板,每个链接填写一行,并保存为 CSV。

  3. 上传文件,并选择默认值,用于某列为空的行,例如模板或标签。

  4. 检查文件。Posty5 会读取每一行但不创建任何内容,并列出将会失败的行。

  5. 开始导入。您可以离开此页面,导入完成后会收到通知。

只有 url 列是必填的。列名不区分大小写,Posty5 无法识别的列会被忽略,并在检查步骤中报告。

Column
url目标地址。必填。也接受 baseUrl 作为它的另一个名称。
name用于您自己列表的名称。留空时,Posty5 会在后台用页面标题填充。
customId短链接的自定义结尾,前提是您的套餐允许自定义 ID。它必须未被使用,包括同一文件中较早的行。
tag用于日后对链接分组和筛选的标签。
refId您自己的引用,例如您系统中的商品编码。
templateId此行的二维码模板。它会覆盖您选择的默认值。
url,name,customId,tag,refId,templateId
https://example.com/spring-sale,Spring sale,,spring,,

请将文件保存为 UTF-8 CSV,使用逗号分隔并带有标题行。包含逗号的值需用双引号括起来,电子表格应用会自动处理。

检查使用与手动创建链接相同的规则,并显示每个失败的行及其行号(从标题下的第一行开始计数)。以下情况下该行会失败

  • URL 缺失、不是有效的网址,或超过 2,048 个字符
  • URL 因不安全而被拦截
  • 名称、标签或引用超过 255 个字符
  • 自定义 ID 在您的套餐中不可用、无效或已被使用
  • 模板不存在或不属于您
  • 一个文件最多包含 5,000 行和 2 MB。
  • 您每天(UTC)最多可批量创建 20,000 行,所有导入和 API 调用合并计算。
  • 同一时间只运行一个导入,最多还可以有三个在排队等待。
  • 如果导入过程中积分用完,该行及之后的所有行都会以“积分不足”失败,已创建的链接会保留。

导入页面会显示已处理、已创建和失败的行数,并自动刷新。您可以取消正在运行的导入;取消前创建的链接会保留。

每个链接创建后,页面标题和应用深层链接会在后台获取,因此链接可能会短暂显示其主机名作为名称。

导入完成后,下载其结果文件。您文件中的每一行在其中对应一行。

Column
row您文件中的行号,从标题下的第一行开始计数。
statuscreated、failed、skipped,或在导入未处理到该行就停止时为 notProcessed。
id, shortUrl新链接的 ID 和短地址。
errors该行失败的原因。

另一个文件只包含失败的行及您的原始值,便于您修正后再次上传该文件。

批量任务会列出您最近的导入及其状态和计数。打开其中一个可查看进度或再次下载其文件。

开发者可以在一个请求中发送最多 100 行,并立即为每行获得一个结果,或将最多 5,000 行的文件作为任务提交并轮询其状态。适用相同的限制和检查,并且请求支持 Idempotency-Key 标头,因此重试的请求不会重复创建链接。相关路由记录在 API 参考文档(Swagger)中。

  • POST /api/short-link/bulk
  • POST /api/link-bulk-jobs
  • GET /api/short-link/export

在短链接列表中,选择导出 CSV 或导出 JSON,即可下载您的链接及其访问计数。

  • 导出会使用列表当前应用的筛选条件,因此如只需导出部分内容,请先筛选。
  • 一次导出最多包含 50,000 行,最新的在前。更长的列表会在此处截断,文件会在最后一行(CSV)或 truncated 字段(JSON)中说明。
  • 以 = + - 或 @ 开头的单元格在 CSV 中会加上前导撇号,这样电子表格应用会将其显示为文本,而不是作为公式运行。