URL 만들기 API - v2 ( Legacy )


URL 만들기 API
v2




목차

1. API 용도

2. 사용방법

3. 주의사항

4. 사용예제




1. API 용도


URL 만들기 API는 나만의 한글주소, 또는 영문주소를 만들 수 있습니다.

예를 들어 https://www.youtube.com 의 주소를 https://유튜브.lrl.kr 처럼 만들 수 있습니다.


또 다른 예시로 중고나라 주소가 계속 헷갈리셨다면 중고나라 주소 https://cafe.naver.com/joonggonara.cafe 를

https://중고나라.lrl.kr 처럼 만들어서 기억하기 쉽게 도와줍니다.


이모티콘 첨부도 가능합니다.

예시 : https://🍖.lrl.kr  




2. 사용방법


URL 만들기 API v2 는 네가지 형식의 출력을 지원합니다.


  • 텍스트 (txt/html)
  • JSON
  • XML
  • TEXT (txt/plain)


요구하는 데이터

  • id 값 ( 만들 주소의 이름 https://🍖.lrl.kr 에서 🍖 <- 이부분 )
  • url 값 ( 만들어진 주소 사용 시 이동할 주소 )
  • format 값 ( 출력 형식 설정 )


https://api.lrl.kr/v2/url/?id=만들주소 이름&url=이동할 주소

을 기본 형식으로 사용합니다.



아래는 출력 방식에 따른 API 호출 코드입니다.

예시로 https://example.com 을 사용하는 코드입니다.

id 값과 https://example.com 이 부분을 원하시는 값으로 바꿔 사용해주세요.



텍스트 ( txt/html ) - html 형식의 텍스트 출력


https://api.lrl.kr/v2/url/?id=example&url=https://example.com 
출력 : example.lrl.kr



텍스트 ( txt/plain ) - 일반 텍스트 출력


https://api.lrl.kr/v2/url/?id=example&url=https://example.com&format=text 
출력 : example.lrl.kr



JSON


https://api.lrl.kr/v2/url/?id=example&url=https://example.com&format=json 
출력 : {"url":"https:\/\/example.com","result":"example.lrl.kr"}



XML


https://api.lrl.kr/v2/url/?id=example&url=https://example.com&format=xml 
출력 : 
<response>
<url>https://example.com</url>
<result>example.lrl.kr</result>
</response>



3. 주의사항

url 은 반드시 http:// 또는 https:// 를 넣어주셔야 정상적으로 생성 됩니다.


URL을 생성하다 보면 id 값이 겹치는 경우가 존재합니다.

이미 생성된 주소의 id 값과 url 값이 동일한 요청일 경우 같은 값을 반환하지만 

생성된 주소의 id값은 일치하나 url값이 일치하지 않을 경우 id 뒤에 임의의 3자리 코드를 붙여 생성합니다.


예시:


사용자 1 -> ( id: 네이버 url: https://naver.com 주소생성 = 네이버.lrl.kr )

사용자 2-> ( id: 네이버 url: https://daum.net 주소생성 = 네이버1dx.lrl.kr )


직접 확인해보실 수 있습니다.

https://api.lrl.kr/v2/url/?id=네이버&url=https://naver.com ( 이미 생성된 주소의 id값과 url값이 동일한 요청 )

https://api.lrl.kr/v2/url/?id=네이버&url=https://daum.net ( 이미 생성된 주소와 id는 같지만 url이 다른 요청 )



버그 및 오류 발견 시 신고 및 문의 게시판에 글을 남겨주세요. ( 비회원 글작성 가능 )




4. 사용예제


  • ajax
  • curl
  • json

첨부파일의 ZIP을 받으신 후 웹서버에 올리고 사용하시면 됩니다.

간단한 URL 만들기 예제입니다.