批量导入和导出短链接
当您需要缩短几十甚至几千个 URL 时,可以将它们放在一个 CSV 文件中上传,而不必逐个手动创建。每一行都会成为一个普通短链接,您可以像其他链接一样编辑、分享和跟踪。
从 CSV 文件导入短链接
Section titled “从 CSV 文件导入短链接”-
在控制台中打开网址缩短器,然后选择批量导入。
-
下载 CSV 模板,每个链接填写一行,并保存为 CSV。
-
上传文件,并选择默认值,用于某列为空的行,例如模板或标签。
-
检查文件。Posty5 会读取每一行但不创建任何内容,并列出将会失败的行。
-
开始导入。您可以离开此页面,导入完成后会收到通知。
只有 url 列是必填的。列名不区分大小写,Posty5 无法识别的列会被忽略,并在检查步骤中报告。
| Column | |
|---|---|
url | 目标地址。必填。也接受 baseUrl 作为它的另一个名称。 |
name | 用于您自己列表的名称。留空时,Posty5 会在后台用页面标题填充。 |
customId | 短链接的自定义结尾,前提是您的套餐允许自定义 ID。它必须未被使用,包括同一文件中较早的行。 |
tag | 用于日后对链接分组和筛选的标签。 |
refId | 您自己的引用,例如您系统中的商品编码。 |
templateId | 此行的二维码模板。它会覆盖您选择的默认值。 |
url,name,customId,tag,refId,templateIdhttps://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 | 您文件中的行号,从标题下的第一行开始计数。 |
status | created、failed、skipped,或在导入未处理到该行就停止时为 notProcessed。 |
id, shortUrl | 新链接的 ID 和短地址。 |
errors | 该行失败的原因。 |
另一个文件只包含失败的行及您的原始值,便于您修正后再次上传该文件。
批量任务会列出您最近的导入及其状态和计数。打开其中一个可查看进度或再次下载其文件。
通过 API 批量创建
Section titled “通过 API 批量创建”开发者可以在一个请求中发送最多 100 行,并立即为每行获得一个结果,或将最多 5,000 行的文件作为任务提交并轮询其状态。适用相同的限制和检查,并且请求支持 Idempotency-Key 标头,因此重试的请求不会重复创建链接。相关路由记录在 API 参考文档(Swagger)中。
POST /api/short-link/bulkPOST /api/link-bulk-jobsGET /api/short-link/export
导出您的链接
Section titled “导出您的链接”在短链接列表中,选择导出 CSV 或导出 JSON,即可下载您的链接及其访问计数。
- 导出会使用列表当前应用的筛选条件,因此如只需导出部分内容,请先筛选。
- 一次导出最多包含 50,000 行,最新的在前。更长的列表会在此处截断,文件会在最后一行(CSV)或 truncated 字段(JSON)中说明。
- 以 = + - 或 @ 开头的单元格在 CSV 中会加上前导撇号,这样电子表格应用会将其显示为文本,而不是作为公式运行。