REST API가 먼데요...

📡 REST

Representational State Transfer
- 자원 (Resource) : URI
- 행위 (Verb) : HTTP Method
- 표현 (Representations) : Server 응답

HTTP URI를 통해 자원을 명시하고 HTTP Method(POST, GET, PUT, DELETE)를 통해 해당 자원에 대한 CRUD Operation을 적용하는 것을 의미한다. 즉, REST는 자원 기반의 구조 설계의 중심에 Resource가 있고, HTTP Method를 통해 Resource를 처리하도록 설계된 아키텍처를 의미한다.

 

영화를 검색하는 사이트가 있다고 가정했을 때

• /createMovie
• /seeMovie
• /getMovie/inception
• /deleteMovie/inception
• /updateMovie/inception
• /getTopRatedMovies
• /findMoviesFromThisYear

API를 이렇게 설계하는 경우 명확한 패턴이 없기 때문에 팀원들이 이해하기 힘들다. 표준이 없기 때문이다. 표준이 있기 위해서는 URL에서 동사를 사용하지 않고 명사만 남긴다.

Movies

Inception (unique identifier)

 

• /movies
• /movies/inception

 

해당 API URI에 HTTP method를 결합한다.

💡 HTTP method

GET	서버로부터 데이터 취득
POST	서버에 데이터 추가, 작성
PUT	서버의 데이터 갱신, 작성
DELETE	서버의 데이터 삭제

 

• GET /movies : 모든 영화 리스트를 취득한다.
• POST /movies : 영화 리스트를 추가한다.
• GET /movies/inception : 인셉션의 정보를 취득한다.
• PUT /movies/inception : 인셉션의 정보를 변경한다.
• DELETE /movies/inception : 인셉션을 삭제한다.

 

검색이나 필터를 처리하기 위해서는 쿼리 파라미터를 사용한다. 페이지네이션도 가능하다.

• /movies?min_rating=9.8
• /movies?release_date=2021
• /movies?pageNum=2&size=8

 

📡 REST의 특징

• Server - Client 구조
  • 자원이 있는 쪽이 서버, 자원을 요청하는 쪽이 클라이언트가 된다.
• Stateless
  • 이전의 요청이 다음의 요청에 연관되지 않는다. 세션 정보나 쿠키 정보를 별도로 저장하고 관리하지 않기 때문에 API 서버는 들어오는 요청만을 단순히 처리한다. 이를 통해 서버의 처리 방식에 일관성을 부여하고 불필요한 정보를 관리하지 않음으로써 구현이 단순해진다.
• Cacheable
  • HTTP의 캐싱 기능을 적용할 수 있다.

• Uniform Interface
  • URI로 지정한 리소스에 대한 조작을 통일되고 한정적인 인터페이스로 수행하는 아키텍처 스타일
• 자체 표현 구조
  • REST API 메시지만 보고도 이를 쉽게 이해할 수 있는 자체 표현 구조
• 계층형 구조
  • REST 서버는 다중 계층으로 구성될 수 있으며 보안, 로드 밸런싱, 암호화 계층을 추가해 구조상의 유연성을 둘 수 있고, Proxy, 게이트웨이 같은 네트워크 기반의 중간 매체를 사용할 수 있게 한다.

 

📡 REST의 장점

• REST API 메시지를 읽는 것만으로도 메시지가 의도하는 바를 명확하게 파악할 수 있다.
  • Stateless한 특징 때문에 해당 URI와 원하는 메서드 자체만 독립적으로 이해하면 됨
• 클라이언트와 서버의 역할이 명확하게 분리되어 있어 업무량 감소, 플랫폼 독립성 확장의 효과
• 헤더 부분에 URI 처리 메서드를 명시함으로써, 필요한 실제 데이터를 페이로드(바디)에 표현할 수 있도록 구성할 수 있는 기능을 제공한다.
  • 특정 메서드의 세부적인 표현 문구를 JSON, XML 등 다양한 언어를 이용하여 작성할 수 있다는 장점뿐만 아니라, 간결한 헤더 표현을 통한 가독성 향상이라는 효과가 있다.

 

📡 REST의 단점

• 메서드 형태가 제한적이다.
• 공식화된 API 디자인 가이드가 존재하지 않는다.

 

📡 Reference

RESTful API란 무엇인가요? - RESTful API 설명 - AWS

REST API의 장점, 그리고 단점