URL 短链接 API
通过一个 REST API 创建品牌短链接、跟踪每一次点击,并管理数百万条 URL。免费起步,为规模化而生。
每月 1,000 次免费 API 调用 · 无需信用卡 · 提供 OpenAPI 3.0 规范 · 符合 GDPR
# Shorten a URL in one call
curl -X POST "https://app.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
}大规模交付品牌短链接所需的一切
一个 REST API。创建、品牌化、路由并分析你的应用发出的每一条链接。
创建并更新链接
通过 REST 以编程方式创建、更新或删除短链接。每次请求可批量创建多达 1,000 个 URL。每条链接均默认支持点击跟踪、地理数据和设备分析。
品牌化自定义域名
在每条通过 API 创建的链接上使用你自己的域名(yourbrand.com/promo)。可连接无限自定义域名,通过 Let's Encrypt 自动 SSL,无需 DNS 专业知识。
实时点击 webhook
订阅点击事件并在数秒内接收 POST 回调。可用于实时归因、欺诈检测、转化跟踪,或将点击数据导入你的数据仓库。
分析 API
通过 REST 获取点击数、地理分布、设备和操作系统数据,以及来源归因。可导出为 JSON 或推送至你的 BI 工具。支持按链接或按账户聚合。
为开发者打造 — 5 分钟内获得你的第一条短链接
使用 bearer token 进行身份验证,POST 一个 URL,即可获得一条短链接。任何语言下的请求结构都相同。
curl -X POST "https://app.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 构建什么
从短信营销活动到 AI 代理 — 一个 API,无限场景。
为你的技术栈强力赋能
在工作流中自动化链接创建,或让 AI 代理直接管理你的短链接。
简单、可扩展的定价
在免费版上构建。只有当流量增长时才升级。
基础设施
世界级的企业级基础设施
每条短链接都从 Cloudflare 边缘网络重定向 — 覆盖 100 多个国家的 300 多个数据中心 — 因此无论你的用户在哪里点击,重定向都能在 5 毫秒内解析完成。
托管于 Cloudflare
每次重定向都由 Cloudflare 的全球边缘网络提供 — 而非单一源站区域。没有冷路径,也没有单点故障。
全球 300 多个数据中心
请求在距离用户最近的数据中心解析。圣保罗和新加坡的点击都保持本地化。
全球 5 毫秒以内的重定向
速度快到终端用户察觉不到这一跳 — 即使是全新营销活动链接的第一次点击。
URL 短链接 API — 常见问题
- URL 短链接 API 可以免费使用吗?
- 可以。Linkly 的免费计划包括每月 1,000 次 API 调用和每月 500 次链接点击,提供一个自定义域名以及对分析和 webhook API 的完全访问。注册无需信用卡。
- 如何对 API 请求进行身份验证?
- 在 Linkly 的 Settings → API Keys 下生成一个 API 密钥,然后在每次请求时通过 api_key 查询参数传入(例如 https://app.linklyhq.com/api/v1/link?api_key=YOUR_API_KEY)。在请求体中包含你的 workspace_id。API 密钥可随时轮换。
- API 速率限制是多少?
- 成长版计划下,每个 API 密钥每秒 100 次请求,突发能力可达每秒 500 次请求。企业版计划包含按用量扩展的专属速率限制。每次响应都会返回速率限制头,以便客户端自我节流。
- 我可以通过 API 创建品牌短链接吗?
- 可以。将一个自定义域名连接到你的 Linkly 账户(一次性 DNS 步骤),然后在 API 请求体中将其作为 domain 字段传入(例如 "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 也不会破坏已经投放的链接。系统会通过电子邮件通知你并提示升级。这对那些不能承受密码重置邮件中链接失效的事务性发送方尤为重要。
- 如何处理大批量 SMS 发送 — 比如每月 1,000 万条链接?
- 批量创建端点每次请求可接受多达 1,000 个 URL。结合突发速率限制和专属企业级基础设施,Linkly 客户在生产中每月发送超过 1,000 万条 SMS 链接。请联系销售获取批量报价和专属 SLA。
- Linkly 的可用性 SLA 是多少?
- 在重定向路径(关键面)上测得 99.9%。状态页面 status.linklyhq.com 显示历史可用性。企业版计划包含带服务积分的合同型 SLA。
- API 是否支持符合 GDPR 的数据处理?
- 支持。Linkly 默认符合 GDPR,企业版计划下可提供欧盟数据驻留。所有付费客户均可获得数据处理附加协议。webhook 负载可配置为排除可识别个人信息,以满足更严格的合规需求。