短网址 API
tlnk.kr API让完成邮箱验证的会员带上X-API-Key和X-API-Secret请求头调用POST /api/v1/shorten，即可以JSON形式拿到自动代码短网址。适合在文章发布、电子报和自动化工作流中，无需手动操作地生成各渠道的推广链接。
获取 API 密钥
免费注册并完成邮箱验证后，即可在“我的页面 › API”中生成密钥。
接口地址
POST
https://tlnk.kr/api/v1/shorten认证
将获得的值放入 X-API-Key 和 X-API-Secret 请求头中发送。请勿把 Secret 放在网址（查询字符串）里。
请求
请求体使用 JSON {"url": "…"} 或表单（url=…）。API 不支持指定子域名或代码。
curl -X POST https://tlnk.kr/api/v1/shorten \
-H "X-API-Key: ak_…" \
-H "X-API-Secret: sk_…" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/very/long/path?utm_source=newsletter"}'
import requests
r = requests.post("https://tlnk.kr/api/v1/shorten",
headers={"X-API-Key": "ak_…", "X-API-Secret": "sk_…"},
json={"url": "https://example.com/very/long/path"}, timeout=30)
print(r.status_code, r.json()["short_url"] if r.ok else r.json())
响应
{
"ok": true,
"code": "Ab3d",
"short_url": "https://tlnk.kr/Ab3d",
"target_url": "https://example.com/very/long/path?utm_source=newsletter",
"created_at": "2026-09-25T09:00:00+09:00",
"daily_remaining": 999
}
错误
{
"ok": false,
"error": "check_failed",
"check": "age",
"message": "…"
}
| 状态码 | error 值 | 含义 |
|---|---|---|
400 | url_required | 需要提供 url 值。 |
400 | bad_json | JSON 请求体格式不正确。 |
401 | auth | API 密钥或 Secret 不正确。 |
403 | key_blocked | 此 API 密钥已被封禁。 |
403 | member_blocked | 该账户的 API 使用已被封禁。 |
405 | method | 仅接受 POST 请求。 |
422 | check_failed | 未通过安全检查（原因代码见 check）。 |
429 | rate_limited | 请求过多，请稍后再试。 |
429 | daily_limit | 已达到 24 小时创建上限。 |
429 | too_many_failures | 未通过安全检查的网址过多，请稍后再试。 |
500 | error | 临时错误，请稍后再试。 |
限额：每个账户每分钟 60 个，每 24 小时 1,000 个。
可以接入哪些工作流?
只要需要链接的时间点是确定的，就都能接入。博客或CMS发布文章时、用电子报工具准备推广时、Zapier或Make这类无代码工具或Google Apps Script处理推广表格中的新行时，只需一次HTTP请求拿到短地址，再交给下一步即可。
同一个原始网址，按渠道换用不同的UTM值，例如utm_source=instagram和utm_source=newsletter，分别缩短后，就能在“我的页面”里把各条链接的点击和来源并排对比，看出哪个渠道更有效。UTM的写法整理在如何添加UTM参数中。
- CMS或博客发布时生成用于分享的短网址
- 电子报和推送活动的链接在发送前准备好
- Zapier、Make、Google Apps Script场景中的HTTP步骤
- 生成分渠道UTM链接，对比效果
请求该怎么发?
把原始地址作为url的值发送到POST /api/v1/shorten。JSON请求体({"url": "https://..."})和普通表单提交都可以，认证通过请求头X-API-Key和X-API-Secret完成。成功后会返回包含short_url、code、target_url的JSON。
API只会生成像tlnk.kr/Ab3d这样的自动代码链接，无法自选代码；如需brand.tlnk.kr这类子域名链接，请在网页上创建。如果目标地址没通过安全检查，返回的不是链接，而是check_failed错误和原因代码，建议在工作流中单独处理这一分支。
密钥如何签发和保管?
免费注册并完成邮箱验证后，就能在“我的页面”的API标签中创建密钥。公开标识API Key以ak_开头，保密值API Secret以sk_开头，同时可处于有效状态的密钥为3个。按用途分开(博客用、电子报用、自动化工具用)，即使作废其中一个，其他工作流也不会中断。
Secret只在创建后显示一次，服务器以无法还原的形式保存，因此之后没有办法再查看。丢失后请作废该密钥并重新签发。请把它放在自动化工具的机密变量或服务器环境变量里，不要留在浏览器JavaScript、公开代码仓库或共享模板中。
通过API创建的链接和网页检查一样吗?
是的，只是入口不同，标准完全一样。会确认域名注册是否满1个月（30天）、能否实际连接、是否在KCSC屏蔽名单或URLhaus、OpenPhish中、是否含违法内容关键词；每经过一个转交地址都会重新审视，内网地址一律拒绝。创建后还会每3小时及每次访问时复查，三人分别举报即自动封禁。
批量生成时要注意哪些限额?
每个账户对每分钟和每24小时的生成数量，以及同时处理的请求数都有上限。短时间内大量发送无法通过检查的地址，请求会被暂时拒绝。触及上限时，响应里的Retry-After值会告诉你需要等待多久，请让自动化场景按此暂停后再重试。
短时间内大批量生成链接的账户会由运营方核查，如判断为垃圾信息或短信诈骗等不当使用，可能会封禁该密钥或整个账户的API使用。运营原则见关于tlnk.kr。
常见问题
API免费吗?
会员可免费使用，但需在每分钟和每24小时的生成限额内使用。
API链接能用品牌子域名吗?
不能。API只生成自动代码链接。像brand.tlnk.kr这样的名称(4至32位小写字母、数字或连字符)需在网页上创建，证书也会自动签发。
不小心把Secret推送到了公开仓库。
请立即在“我的页面 › API”中作废该密钥，签发新密钥并更新工作流设置。使用已作废密钥的请求会被马上拒绝。
通过API创建的链接，分渠道效果在哪里看?
它们和网页上创建的链接一起显示在“我的页面”的短网址列表中，同样可以查看点击、来源、国家、设备统计，修改目标地址或暂停。
推广结束后的API链接也会自动清理吗?
会。和其他链接一样，3个月（90天）内没有点击就会被删除，删除后的地址1年内不会被再次使用。