REST, REST API, RESTFul API

오늘은 RESTFul API에 대해 공부하도록 하겠습니다.

---

REST란?

출처 : https://icon-library.com/icon/rest-api-icon-14.html

REST(Representational State Transfer)의 약자로 자원을 이름으로 구분하여 해당 자원의 상태를 주고 받는 모든 것을 의미합니다.

 

즉 REST란

1. HTTP URI(Uniform Resource Identifier)를 통해 자원 을 명시하며

2. HTTP Method(POST, GET, PUT, DELETE)를 통해

3. 해당 자원 (URI)에 대한 CRUD Operation을 적용하는 것을 의미합니다.

 

CRUD는 대부분의 컴퓨터 소프트웨어가 가지는 기본적인 데이터 처리 기능인 Create, Read, Update, Delete를 묶어서 일컫는 말입니다.

 

 

---

REST의 기본 구성

REST는 다음과 같은 3가지로 구성이 되있습니다.

 

1. 자원 : HTTP URI

2. 자원에 대한 행위 : HTTP Method

3. 자원에 대한 행위의 내용 : HTTP Message Pay Load

 

REST의 장단점

장점

 

1. HTTP 프로토콜의 인프라를 그대로 사용하므로 REST API 사용을 위한 별도의 인프라를 구출할 필요가 없음

2. HTTP 프로토콜의 표준을 최대한 활용하여 여러 추가적인 장점을 함께 가져감

3. HTTP 표준 프로토콜에 따르는 모든 플랫폼에서 사용 가능

4. Hypermedia API의 기본을 충실히 지키면서 범용성을 보장

5. REST API 메시지가 의도하는 바를 명확하게 나타내므로 의도파악이 쉬움

6. 여러 가지 서비스 디자인에서 생길 수 있는 문제를 최소

7. 서버와 클라이언트의 역활을 명확히 구분

 

단점

1. 표준이 자체가 존재하지 않아 정의가 필요

2. 사용할 수 있는 메소드가 4개지만 있음

3. HTTP Method 형태가 제한적

4. 브라우저를 통해 테스트할 일이 많은 서비스라면 쉽게 고칠 수 있는 URL보다 Header 정보의 값을 처리해야함으로 전문성이 필요

5. 구형 브라우저에서 호환이 되지 않아 지원해주지 못하는 동작이 많음

 

---

REST API(REST API)

출처 : https://hanamon.kr/rest-api-%EB%94%94%EC%9E%90%EC%9D%B8-%EA%B0%80%EC%9D%B4%EB%93%9C/

REST API란 REST의 원리를 따르는 API를 의미합니다.

• API란?
  • 데이터와 기능의 집합을 제공하여 컴프터 프로그램간 상호작용을 촉진, 서로 정보를 교환 가능 하도록 하는것
• REST API의 정의
  • REST 기반으로 서비스 API를 구현한 것
  • OpenAPI

REST API의 특징

• 사내 시스템들도 REST 기반으로 시스템을 분산해 확장성과 재사용성을 높여 유지보수 및 운용을 편리하게 함
• REST는 HTTP 표준을 기반으로함
• 즉, REST API를 제작하면 자바, C#, 웹 등을 이용해 클라이언트를 제작 가능

REST API의 규칙

1. URI는 동사보다는 명사를, 대문자보다는 소문자를 사용해야함

2. 마지막에 슬래시 (/)를 포함하면 안됨

3. 언더바(_) 대신 하이폰(-)을 사용

4. 파일확장자는 URI에 포함하지 않는다.

5. 행위를 포함하지 않는다.

---

RESTFul이란?

출처 : https://gmlwjd9405.github.io/2018/09/21/rest-and-restful.html

RESTFul은 REST의 원리를 따르는 시스템을 의미합니다. 하지만 REST를 사용했다 하여 모두가 RESTFul 을 사용한 것이 아닙니다. REST API의 설계 규칙을 올바르게 지킨 시스템을 RESTFul하다 말할 수 있으며

모든 CRUD 기능을 POST로 처리 하는 API  혹은 URI 규칙을 올바르게 지키지 않은 API는 REST API의 설계 규칙을
올바르게 지키지 못한 시스템은 REST API를 사용하였지만 RestFul 하지 못한 시스템입니다.

 

RESTFul의 목적

1. 이해하기 쉽고 사용하기 쉬운 REST API를 만드는 것

2. RESTFul한 API를 구현하는 근본적인 목적이 성능 향상에 있는 것이 아니라 일관적인 통한 API의 이해도 및 호환성을 높이는 것이 주 동기이니, 성능이 중요한 상황에서는 굳이 RESTFul한 API를 구현할 필요가 없음

 

---

References

1.https://khj93.tistory.com/entry/%EB%84%A4%ED%8A%B8%EC%9B%8C%ED%81%AC-REST-API%EB%9E%80-REST-RESTful%EC%9D%B4%EB%9E%80

[네트워크] REST API란? REST, RESTful이란?

2. https://gmlwjd9405.github.io/2018/09/21/rest-and-restful.html

[Network] REST란? REST API란? RESTful이란? - Heee's Development Blog