短信发送用短链接 API
lsu.kr API是一项会员功能，可把短信发送程序要发给顾客的预约、订单、配送通知地址变成短链接。完成邮箱验证的会员获取密钥后，把地址发送到POST /api/v1/shorten，短链接就会以JSON形式返回。
获取 API 密钥
免费注册并完成邮箱验证后，即可在“我的页面 › API”中生成密钥。
接口地址
POST
https://lsu.kr/api/v1/shorten认证
将获得的值放入 X-API-Key 和 X-API-Secret 请求头中发送。请勿把 Secret 放在网址（查询字符串）里。
请求
请求体使用 JSON {"url": "…"} 或表单（url=…）。API 不支持指定子域名或代码。
curl -X POST https://lsu.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://lsu.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://lsu.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 个。
哪些小店和社群用得上?
美发店、诊所、餐馆的预约确认短信，小菜店、花店的接单与配送查询通知，兴趣小组或小区群在Band、群聊里发布的报名地址——凡是需要按顾客或按通知频繁发送不同长地址的场合都很合适。发送程序在短信发出前一刻取得链接并嵌入正文，店员不必一条条手动缩短。
韩国的短文短信只有约80字节(约40个韩文字)，一个长地址就可能占满。用短链接就能从容写下店名和说明文字。具体标准请看短信字数限制。
- 到店前一天的提醒短信里放预约确认页
- 接单、发货短信里放配送查询页
- 向许多顾客发送优惠券或活动通知时
- 从Excel或Google表格的顾客名单为每人生成链接
第一次接入要准备什么?
① 免费注册并完成邮箱验证。② 在“我的页面”的API标签中创建密钥。以ak_开头的API Key和以sk_开头的API Secret是一对，一个账户最多可保留3个使用中的密钥，方便按门店或按程序分开使用。③ 在发送程序的设置中，把两个值填入请求头X-API-Key和X-API-Secret，并把要缩短的地址作为url的值传入。
Secret只会在签发页面显示一次，服务器上只保留无法还原成原值的形式。没来得及记下的话，请作废该密钥并重新领取。不要把Secret贴在店员共用电脑的记事本或群聊里，只保存在发送程序的设置中。
发给顾客的链接怎样检查?
通过API提交的地址也走和页面创建时相同的标准：域名是否存在超过1个月（30天）、能否访问、是否在KCSC屏蔽名单或URLhaus、OpenPhish中、是否含违法内容关键词，途中转向的地址和内部地址也会一并确认。不通过时返回的不是链接，而是check_failed和原因代码，请先别给这位顾客发短信，先核对地址。
发出后，顾客每次点击以及每3小时都会复查，收到三个人的举报就自动拦截。顾客在链接末尾加+预先查看去向的方法，请见如何识别诈骗短信里的短链接。
一次群发时有需要遵守的限额吗?
每个账户在1分钟和24小时内可生成的数量、同时进入的请求数都有上限；被检查拒绝的地址若在短时间内集中出现，会暂时不再受理请求。超出限额时，请让发送程序按响应中Retry-After给出的时间等待，再继续发送。
短时间内批量产出大量链接的账户，运营方会亲自核查。如疑似广告垃圾短信或短信诈骗，可能会封禁该密钥或整个账户的API使用。运营原则可在关于lsu.kr查看。
常见问题
需要另外付费吗?
不需要。会员免费使用，只要在1分钟和24小时的生成限额内即可。
shopname.lsu.kr这样的地址也能用API生成吗?
不能。API只会生成像lsu.kr/Ab3d这样的自动代码链接。带店名的子域名链接请在页面上手动创建。
发送电脑里保存的Secret好像泄露了。
请马上在“我的页面 › API”中作废该密钥，并把发送程序换成新密钥。使用已作废密钥发来的请求从那一刻起都会被拒绝。
能看到短信里发出的链接被点了几次吗?
能。通过API创建的链接也会一起显示在“我的页面”的链接列表中，同样可以查看点击次数、修改目标地址或暂停。