POST AI agent ready /v1/short-url/create

URL Shortener API - 通过点击跟踪创建短链接

提交 URL 并接收包含自动生成或自定义 slug 的缩短链接。短链接通过 302 重定向并跟踪点击次数。自定义别名支持字母、数字、连字符和下划线。如果已获取 slug，API 会返回错误，以便您可以使用不同的 slug 重试。

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/short-url/create \
  -H "Content-Type: application/json" \
  -d '{"url":"https://docs.botoi.com/getting-started","custom_slug":"getting-started"}'

When to use this API

为营销活动生成可跟踪的短链接

为每个活动创建一个自定义 slug 短链接（例如 /launch-2026）。使用统计端点来跟踪点击次数并衡量参与度，无需外部分析工具。

在您的 SaaS 产品中构建链接缩短器功能

让您的用户在您的应用程序内创建品牌短链接。该 API 处理 slug 生成、碰撞检测和重定向跟踪，因此您无需构建该基础设施。

Frequently asked questions

短链接会过期吗？

通过 API 创建的短链接没有内置过期时间。它们会一直保留在存储中，直到手动删除或清除底层存储为止。

如果我的自定义 slug 已被占用，会发生什么情况？

API 返回 SLUG_TAKEN 错误。您可以使用不同的 slug 重试或省略 custom_slug 字段以获取自动生成的 6 字符 slug。

自定义 slug 中允许使用哪些字符？

字母（A-Z、a-z）、数字（0-9）、连字符（-）和下划线（_）。任何其他字符都会导致 INVALID_SLUG 错误。

是否会自动跟踪点击次数？

是的。每次有人访问短网址时，点击计数器都会增加。使用 /v1/short-url/stats 端点来检索当前计数。

短 URL 使用什么类型的重定向？

短 URL 返回 302（临时）重定向。这意味着搜索引擎不会将链接资产转移到目标 URL，您可以稍后根据需要更改目标。

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.