고객센터
API란?
- API에 대해 안내드립니다.
-
Buly API 는 무엇인가요?
Buly API 는 회원이 자신의 서비스·프로그램에서 단축 URL 을 자동으로 만들 수 있게 해 주는 HTTP 인터페이스입니다. 회원가입 후 상단 메뉴의 API KEY 에서 발급된 Access Key 를 확인하실 수 있으며, 이 키와 회원 아이디로 인증합니다. API 로 만든 단축 URL 은 매번 새로 발급되며(동일 URL 재사용 없음), 웹에서 만든 링크와 같은 방식으로 리다이렉트됩니다. -
단축 URL 생성 API — POST /api/shoturl.sisopost https://luly.co.kr/api/shoturl.siso
요청은 application/x-www-form-urlencoded 로 보냅니다.
/api/shoturl2.siso도 같은 규격입니다.Request Parameter
파라미터 필수여부 타입 설명 customer_id 필수 string 회원가입 아이디 partner_api_id 필수 string buly에서 발급받은 API 코드(Access Key) org_url 필수 string 원 도메인 (단축할 긴 URL) Response
파라미터 타입 설명 값의 범위 result bool 결과 플래그 - 성공 : Y
- 실패 : Nurl string 단축 도메인 key string 단축 키 message string 결과메시지 예시
curl -X POST https://luly.co.kr/api/shoturl.siso \ -d 'customer_id=아이디' \ -d 'partner_api_id=발급받은키' \ -d 'org_url=https://example.com/very/long/link' {"result":"Y","url":"https://luly.co.kr/AbC12x","key":"AbC12x"} -
JSON API — /api/v1/short-links
JSON 으로 요청·응답하는 신규 API 입니다. 인증은
Authorization: Bearer <Access Key>또는X-API-KEY헤더로 합니다.post https://luly.co.kr/api/v1/short-links단축 링크 생성. 인증 없이도 호출할 수 있으며, 키를 보내면 회원 링크로 저장됩니다. 본문은
{"url":"https://..."}, 성공 시 201.get https://luly.co.kr/api/v1/short-links?page=0&size=20내 링크 목록. 인증 필수. 응답은
{ code, message, result: { content: [...], page, size, totalElements } }형식입니다.응답 봉투
{ "code": 200, "message": "단축 링크가 생성되었습니다.", "result": { "id": 1, "shortKey": "AbC12x", "shortUrl": "https://buly.kr/AbC12x", "targetUrl": "https://example.com/very/long/link", "enabled": true, "viaApi": false, "createdAt": "2026-01-01T00:00:00" } }실패 시
code에 HTTP 상태와 같은 숫자,errorCode에 분기용 키(INVALID_TARGET_URL,BLOCKED_TARGET_URL,UNAUTHORIZED등)가 담깁니다. -
Access Key 는 어디서 확인하나요?로그인 후 상단 메뉴 오른쪽의 API KEY 발급 을 누르면 Access Key 와 요청·응답 규격이 함께 표시되고, 복사 버튼으로 바로 복사할 수 있습니다. 키가 외부에 노출되면 다른 사람이 회원 명의로 링크를 만들 수 있으니 소스코드나 공개 저장소에 올리지 마세요. 회원가입 하러가기
