url 단축 API

v4

목차

1. API 개요

2. 구조 및 응답

   2-1. 전송 구조

   2-2. 수신 구조

   2-3. 응답 및 오류

3. 레퍼런스 코드

🟢 1. API 개요

URL 단축 API v4 는 기존 v3 에 비해 더욱 체계적이고 보안에 신경을 쓴 API 입니다.

응답을 간소화하고 필요한 기능들을 추가하였습니다.

URL 단축 API 를 사용하여 긴 주소를 다량의 짧은 주소로 변환하실 수 있습니다.

HTML, PHP, C, C++, C#, Python 등등 여러 언어에서 사용 가능한 API 입니다.

🟢 2. 구조 및 응답

• 요청 URL : https://api.lrl.kr/v4/url/short
• 데이터 타입 : JSON
• 전송 메소드 : POST

POST 메소드로 전송하며 JSON 타입 데이터를 주고 받습니다.

🔵 2 - 1. 전송 구조

{ 
    url: "https://google.com"
}

형태로 url 값을 전송하면 단축된 url 값을 받을 수 있습니다.

🔵 2 - 2. 수신 구조

{
    "result":{
        "url":"https:\/\/lrl.kr\/bPy"
     },
     "message":"SUCCESS"
}

위 형태의 응답을 받습니다.

result -> url 값이 단축된 주소입니다.

역슬래시 ( \ ) 기호는 JSON 인코딩 과정에서 나오는 것으로 오류가 아닙니다.

🔴 2 - 3. 응답 및 오류

API 는 아래와 같은 http 코드로 응답합니다.

정상적인 응답에는 http 201 값을 반환합니다.

• 200 - 서비스 정상 제공중
• 201 - 요청 성공
• 400 - 잘못된 요청
• 403 - 접근 불가능
• 404 - 존재하지 않는 리소스
• 405 - 잘못된 요청 메소드
• 500 - 서버 오류. 신고 및 문의 게시판에 제보해주세요.

만약 오류가 난 경우 message 값에 다음 메세지를 반환합니다.

• ERR_NO_URL : URL 값을 넣어주세요.
• ERR_INVALID_URL : 올바르지 않은 URL ( https:// 필요 )
• ERR_SHORTENED_URL : 이미 단축된 주소입니다.
• ERR_UNDEFINED : 알 수 없는 오류. 신고 및 문의 게시판에 제보해주세요.

🟢 3. 레퍼런스 (예제) 코드

레퍼런스는 참고자료 라는 뜻으로, API 사용 예제를 보여줍니다.

코드 수정은 자유입니다.

레퍼런스는 https://api.lrl.kr/ref/v4/ 에서 확인하실 수 있습니다.

크롬 우클릭 -> 페이지 소스 보기 를 눌러서 코드를 확인하세요.

또는 크롬 브라우저에 view-source:https://api.lrl.kr/ref/v4/ 를 입력하시면 소스 코드가 나옵니다.