URL缩短API
创建品牌短链接，追踪每一次点击，并通过一个 REST API 管理数百万个 URL。免费入门，按固定费率扩展——您只需为点击付费。
无限链接创建 · 无需信用卡 · 符合 OpenAPI 3.0 规范 · 符合 GDPR 标准
# Shorten a URL in one call
curl -X POST "https://api.linklyhq.com/api/v1/link?api_key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspace_id": 1,
"url": "https://example.com/very-long-url-here",
"name": "summer-campaign",
"domain": "yourbrand.com"
}'
# Response
{
"id": 9512,
"url": "https://example.com/very-long-url-here",
"name": "summer-campaign",
"full_url": "https://yourbrand.com/summer-campaign",
"workspace_id": 1
}您需要的一切，助您大规模发送品牌短链接。
集网址缩短和链接缩短 API 于一体。创建、定制品牌、路由和分析应用发送的每个链接。
创建和更新链接
通过 REST 接口以编程方式创建、更新或删除短链接。一次请求即可批量创建多个链接。每个链接都默认具备点击跟踪、地理位置数据和设备分析功能。
品牌定制域名
在所有通过 API 创建的链接中使用您自己的域名（yourbrand.com/promo）。通过 Let's Encrypt 和 Cloudflare 将您的自定义域名与自动 SSL 连接，无需任何 DNS 专业知识。
实时点击网络钩子
订阅点击事件，即可在数秒内接收 POST 回调。可用于实时归因、欺诈检测、转化跟踪，或将点击数据导入数据仓库。
分析 API
通过 REST 接口提取点击次数、地理位置细分、设备和操作系统数据以及引荐来源归因信息。导出为 JSON 格式或直接导入到您的 BI 工具中。支持按链接分析或汇总整个帐户的数据。
专为开发者打造——5分钟内获取您的第一个短链接
使用 bearer token 进行身份验证，POST 一个 URL，获取返回的短链接。任何语言的请求格式都相同。
curl -X POST "https://api.linklyhq.com/api/v1/link?api_key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspace_id": 1,
"url": "https://example.com/article",
"name": "blog-share"
}'开发者使用 Linkly 构建的内容
从短信营销到人工智能代理——一个API，无限的应用场景。
你的堆栈，超强动力
在工作流程中自动创建链接，或者让 AI 代理直接管理您的短链接。
基础设施
世界一流的企业基础设施
每个短链接都会从 Cloudflare 边缘网络（遍布 100 多个国家/地区的 300 多个数据中心）重定向，因此无论用户点击哪里，重定向都能在 5 毫秒内完成。
由 Cloudflare 提供托管
所有重定向都由 Cloudflare 的全球边缘网络提供服务，而非单一源区域。没有冷路径，也没有单点故障。
全球300多个数据中心
请求会在离您用户最近的数据中心进行处理。无论是在圣保罗还是在新加坡点击，请求都会留在本地。
全球范围内低于 5 毫秒的重定向
速度之快，以至于最终用户根本察觉不到跳转——即使是第一次点击全新的活动链接也是如此。
URL缩短API——常见问题解答
- URL缩短API可以免费使用吗？
- 是的。Linkly 的免费套餐包含每月 500 次链接点击和一个自定义域名，并可访问链接、分析和 Webhook API。免费套餐的分析 API 每月允许 100 次请求（付费套餐为 1000 次）。注册无需信用卡。
- Linkly既是链接缩短API又是URL缩短API吗？
- 是的——“链接缩短 API”和“URL 缩短 API”指的是同一件事，而 Linkly 同时具备这两种功能。它们都使用相同的 REST 接口来缩短任何 URL，附加自定义品牌域名，追踪每一次点击，并发送 POST Webhook，因此您可以将 Linkly 集成到任何需要程序化链接缩短的地方。
- 如何验证 API 请求？
- 在 Linkly 的“设置”→“API 密钥”中生成 API 密钥，然后将其作为 api_key 查询参数传递到每个请求中（例如，https://api.linklyhq.com/api/v1/link?api_key=YOUR_API_KEY）。在请求正文中包含您的 workspace_id。API 密钥可以随时轮换。
- API 速率限制是多少？
- 链接创建端点允许每个工作区每秒最多发起 100 个请求。分析 API 限制为每个工作区每小时最多发起 50 个请求。如果超出限制，API 将返回 HTTP 429 错误，并在响应正文中显示您当前的请求使用情况和限制。
- 我可以通过API创建品牌短链接吗？
- 是的。将自定义域名连接到您的 Linkly 帐户（只需进行一次 DNS 设置），并将其作为域名字段传递到您的 API 请求正文中（例如，“domain”:“yourbrand.com”）。通过 API 创建的每个链接都将使用您的品牌域名——例如 yourbrand.com/summer-sale 而不是 l.linklyhq.com/abc。
- Linkly是否提供点击事件的webhook？
- 是的。订阅 Webhook 端点后，Linkly 会在几秒钟内将每次点击事件 POST 到您的 URL。有效载荷包括链接 ID、点击时间戳、地理位置数据、设备和浏览器信息以及引荐来源网址。可用于实时归因、欺诈检测和数据仓库管道。
- 是否存在 OpenAPI 规范？
- 是的。Linkly 发布了 OpenAPI 3.0 规范，可以导入到 Postman、Insomnia 和大多数 API 客户端生成器中。该规范与生产环境保持同步，不存在版本漂移。
- 如果我的点击次数超过了套餐限制会怎么样？
- 链接持续重定向——即使您超出套餐限额，Linkly 也不会破坏实际使用的链接。您会收到电子邮件通知，并被提示升级。这对于交易型邮件发送者来说尤为重要，因为他们无法承受密码重置邮件中出现失效链接的后果。
- 如何处理大量短信发送——例如，每月 1000 万条链接？
- 批量创建端点允许每次请求提交多个 URL，而专用的 Cloudflare 边缘基础设施则可处理高流量的推广活动。无限流量套餐以固定的月费提供大批量发送服务，点击次数真正不限——无需询价，也无需销售电话，只需注册即可使用。
- Linkly的正常运行时间SLA是什么？
- 重定向路径（关键接口）的正常运行时间达到 99.9%。状态页面 status.linklyhq.com 显示历史正常运行时间。无限流量套餐包含服务级别协议 (SLA) 及服务抵扣额度。
- 该API是否支持符合GDPR的数据处理？
- 是的。Linkly 默认符合 GDPR 标准，企业版套餐还提供欧盟数据驻留选项。所有付费客户均可获得数据处理附录。Webhook 有效负载可以配置为排除个人身份信息，以满足更严格的合规性需求。