문자 발송용 짧은 링크 API

Q: 가게이름.lsu.kr 주소도 API로 만들 수 있나요?

아니요. API로는 lsu.kr/Ab3d 같은 자동 코드 링크만 만들어집니다. 가게 이름을 넣은 서브도메인 링크는 화면에서 직접 만들어 주세요.

lsu.kr API는 문자 발송 프로그램이 손님에게 보낼 예약·주문·배송 안내 주소를 짧은 링크로 바꿔 주는 회원 기능입니다. 이메일 인증을 마친 회원이 키를 받아 POST /api/v1/shorten 에 주소를 보내면 짧은 링크가 JSON으로 돌아옵니다.

API 키 받기

무료 회원가입 후 이메일 인증을 마치면 마이페이지 › API 에서 키를 발급받을 수 있습니다.

무료 회원가입 로그인

엔드포인트

POSThttps://lsu.kr/api/v1/shorten

인증

발급받은 값을 X-API-Key 와 X-API-Secret 헤더에 넣어 보냅니다. 비밀값은 주소(쿼리 문자열)에 넣지 마세요.

요청

본문은 JSON {"url": "…"} 또는 form(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`	일시적인 오류입니다. 잠시 후 다시 시도하세요.

요청 한도: 계정당 1분 60개, 24시간 1,000개.

어떤 가게·모임에 쓸모가 있나요?

미용실·병원·식당의 예약 확인 문자, 반찬가게·꽃집의 주문 접수와 배송 조회 안내, 동호회나 아파트 모임이 밴드·단톡방에 올리는 참가 신청 주소처럼, 손님마다 또는 공지마다 다른 긴 주소를 자주 보내야 할 때 알맞습니다. 발송 프로그램이 문자를 보내기 직전에 링크를 받아 본문에 끼워 넣으므로 직원이 한 건씩 줄일 필요가 없습니다.

단문 문자는 80바이트(한글 약 40자) 안팎이라 긴 주소 하나만으로 꽉 차기 쉽습니다. 짧은 링크를 쓰면 가게 이름과 안내 문구를 넉넉히 적을 수 있습니다. 자세한 기준은 문자 글자 수 제한을 보세요.

방문 하루 전 알림 문자에 예약 확인 페이지 넣기
주문 접수·배송 출발 문자에 조회 페이지 넣기
쿠폰·행사 안내를 여러 손님에게 보낼 때
엑셀·구글 시트 손님 명단에서 사람별 링크 만들기

처음 연결할 때 무엇을 준비하나요?

① 무료 회원가입 후 이메일 인증을 마칩니다. ② 마이페이지 API 탭에서 키를 만듭니다. ak_ 로 시작하는 API Key와 sk_ 로 시작하는 API Secret이 한 쌍이며, 한 계정에 사용 중인 키는 3개까지 둘 수 있어 매장별·프로그램별로 나눠 쓰기 좋습니다. ③ 발송 프로그램 설정에서 요청 헤더 X-API-Key, X-API-Secret 에 두 값을 넣고, 보낼 주소를 url 값으로 전달하게 합니다.

Secret은 발급 화면에서 딱 한 번만 보이고, 서버에는 원래 값으로 되돌릴 수 없는 형태로만 남습니다. 적어 두지 못했다면 그 키를 폐기하고 새로 받으세요. 여러 직원이 함께 쓰는 PC 메모장이나 단톡방에 Secret을 붙여 두지 말고 발송 프로그램 설정 안에만 보관하세요.

손님에게 가는 링크는 어떻게 검사하나요?

API로 넣은 주소도 화면에서 만들 때와 같은 기준을 거칩니다. 도메인이 생긴 지 1개월(30일)이 넘었는지, 접속이 되는지, 방송통신심의위원회 차단 목록이나 URLhaus·OpenPhish에 올라 있지 않은지, 불법 콘텐츠 키워드가 없는지 보고, 중간에 넘어가는 주소와 내부 주소까지 확인합니다. 통과하지 못하면 링크 대신 check_failed 와 사유 코드가 오므로, 그 손님에게는 문자를 보내지 말고 주소부터 확인하세요.

보낸 뒤에도 손님이 누를 때마다, 또 3시간마다 다시 검사하고, 신고가 세 명에게서 들어오면 자동으로 막습니다. 손님이 링크 끝에 +를 붙여 목적지를 미리 보는 방법은 스미싱 문자 속 짧은 링크 확인법에서 안내합니다.

한꺼번에 보낼 때 지켜야 할 한도가 있나요?

계정마다 1분·24시간 동안 만들 수 있는 개수와 동시에 들어오는 요청 수에 한도가 있고, 검사에서 거절된 주소가 짧은 시간에 몰리면 잠시 요청을 받지 않습니다. 한도를 넘기면 응답에 담긴 Retry-After 시간만큼 기다렸다가 이어서 보내도록 발송 프로그램을 맞춰 두세요.

짧은 시간에 링크를 대량으로 찍어 내는 계정은 운영자가 직접 확인합니다. 광고 스팸이나 스미싱으로 의심되면 키 또는 계정 전체의 API 이용이 막힐 수 있습니다. 운영 원칙은 lsu.kr 소개에서 볼 수 있습니다.

자주 묻는 질문

따로 내는 비용이 있나요?

없습니다. 회원이면 무료이며, 1분·24시간 생성 한도 안에서 이용하면 됩니다.

가게이름.lsu.kr 주소도 API로 만들 수 있나요?

아니요. API로는 lsu.kr/Ab3d 같은 자동 코드 링크만 만들어집니다. 가게 이름을 넣은 서브도메인 링크는 화면에서 직접 만들어 주세요.

발송 PC에 저장된 Secret이 새어 나간 것 같아요.

마이페이지 › API 에서 그 키를 바로 폐기하고, 새 키로 발송 프로그램 설정을 바꾸세요. 폐기된 키로 오는 요청은 그 즉시 거부됩니다.

문자로 보낸 링크가 몇 번 눌렸는지 볼 수 있나요?

네. API로 만든 링크도 마이페이지 링크 목록에 함께 보여, 클릭 수 확인과 목적지 수정·일시 중지를 똑같이 할 수 있습니다.