[SpringBoot] REST API

🌱 REST API란?

REST는 Representational State Transfer라는 용어의 약자로서 REST의 원리를 따르는 API를 의미한다.

📖 REST 
HTTP URI(Uniform Resource Identifier)를 통해 자원(Resource)을 명시하고, HTTP Method(POST, GET, PUT, DELETE, PATCH 등)를 통해 해당 자원(URI)에 대한 CRUD Operation을 적용하는 것을 의미한다.

📖 API(Application Programming Interface)
데이터와 기능의 집합을 제공하여 컴퓨터 프로그램 간 상호작용을 촉진하며, 서로 정보를 교환가능 하도록 하는 것을 의미한다.

📖 CRUD Operation
- Create : 생성(POST)
- Read : 조회(GET)
- Update : 수정(PUT)
- Delete : 삭제(DELETE)
- HEAD : header 정보 조회(HEAD)

 

 

 

🌱 REST 구성 요소

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

• 자원(Resource) : HTTP URI
• 자원에 대한 행위(Verb) : HTTP Method
• 자원에 대한 행위의 내용 (Representations) : HTTP Message Pay Load

 

 

 

🌱 REST 특징

REST는 다음과 같은 특징을 가진다.

• Uniform (유니폼 인터페이스)
  Uniform Interface는 URI로 지정한 리소스에 대한 조작을 통일되고 한정적인 인터페이스로 수행하는 아키텍처 스타일을 뜻한다.
  
  
• Stateless (무상태성)
  REST는 무상태성을 갖기 때문에 작업을 위한 상태정보를 따로 저장하고 관리하지 않는다. 세션 정보나 쿠키 정보를 별도로 저장하고 관리하지 않기 때문에 API 서버는 들어오는 요청만을 단순히 처리한다. 때문에 서비스의 자유도가 높아지고 서버에서 불필요한 정보를 관리하지 않음으로써 구현이 단순해진다.
  
  
• Cacheable (캐시 가능)
  HTTP라는 기존 웹표준을 그대로 사용하기 때문에 HTTP가 가진 캐싱 기능을 사용할 수 있다.
  
  
• Self-descriptiveness (자체 표현 구조)
  REST API 메시지만 보고도 이를 쉽게 이해할 수 있는 자체 표현 구조로 되어 있다.
  
  
• Client - Server 구조
  자원을 요청하는 Client, 자원을 처리하는 Server로 구성되어 책임이 명확해지며 서로 간 의존성이 줄어들게 된다.
  
  
• 계층형 구조
  API Server는 순수 비즈니스 로직을 수행하고 그 앞단에 보안, 로드밸런싱, 암호화, 사용자 인증 등을 추가하여 구조상의 유연성을 줄 수 있다. 또한 로드밸런싱, 공유 캐시 등을 통해 확장성과 보안성을 향상시킬 수 있다. 

 

 

 

🌱 REST API 장점

• HTTP 프로토콜의 인프라를 그대로 사용하므로 REST API 사용을 위한 별도의 인프라를 구축할 필요가 없다.
• HTTP 표준 프로토콜에 따르는 모든 플랫폼에서 사용이 가능하다.
• REST API 메시지가 의도하는 바를 명확하게 나타내므로 의도하는 바를 쉽게 파악할 수 있다.
• 서버와 클라이언트의 역할을 명확하게 분리할 수 있다.

 

 

 

🌱 REST API 디자인

REST에서 가장 중요하며 기본적인 규칙은 아래 두 가지이다.

1. URI는 정보의 자원을 표현해야 한다.
2. 자원에 대한 행위는 HTTP Method(GET, POST, PUT, DELETE)로 표현한다.

그 외 세부 규칙은 다음과 같다.

 

• URI는 정보의 자원을 표현해야 한다. (+ 행위를 포함하지 않는다.)
  🙅‍♂️ GET /members/delete/1
  🙆‍♂️ DELETE /members/1
  
  
• 소문자를 사용한다.
  🙅‍♂️ GET /DOCS/rest_design
  🙆‍♂️ GET /docs/rest-design
  
  
• 슬래시(/)로 계층구조를 나타낸다.
  🙆‍♂️ GET /classes/1/members/1
  
  
• 마지막에 슬래시(/)를 포함하지 않는다.
  🙅‍♂️ GET /members/1/
  🙆‍♂️ GET /members/1
  
  
• 언더바(_) 대신 하이픈(-)을 사용한다.
  🙅‍♂️ GET /docs/rest_design
  🙆‍♂️ GET /docs/rest-design
  
  
• 확장자는 URI에 포함하지 않는다.
  🙅‍♂️ GET /members/1/photo.jpg
  🙆‍♂️ GET /members/1/photo

 

 

 

References.

1. NHN Cloud 기술블로그
2. IBM 기술블로그
3. 히진쓰의 서버사이드 기술 블로그 - [네트워크] REST API란? REST, RESTful이란?