🔎 REST

REST: REpresentational State Transfer

• API 작동 방식에 대한 조건을 부과하는 소프트웨어 아키텍처
• 인터넷과 같은 복잡한 네트워크에서 통신을 관리하기 위한 지침으로 만들어졌다.
• REST 기반 아키텍처를 사용하여 대규모의 고성능 통신을 안정적으로 지원할 수 있고 쉽게 구현하고 수정할 수 있어 모든 API 시스템을 파악하고 여러 플랫폼에서 사용할 수 있다.
  
  
  
  

REST 구성요소

1. Resource: 자원 - URI
   • 모든 자원에 고유한 ID가 존재하고 이 자원은 서버에 존재한다.
   • 자원을 구별하는 ID는 ‘/todos/:todo_id’와 같은 HTTP URI
   • 클라이언트는 URI를 이용해서 자원을 지정하고 해당 자원의 상태에 대한 조작을 서버에 요청한다.
2. Verb: 행위 - HTTP Method
   • HTTP 프로토콜은 GET, POST, DELETE, PUT과 같은 메서드를 제공한다.
3. Representation of Resource: 표현
   - 클라이언트가 자원의 상태에 대한 조작을 요청하면 서버는 적절한 응답을 보낸다.
   - REST에서 하나의 자원은 JOSN, XML, TEXT 등 여러 형태의 표현으로 나타내어질 수 있다.
   - JSON(혹은 XML)을 통해 데이터를 주고 받는 것이 일반적이다.
   
   
   
   

REST 특징

1. Uniform Interface: 균일한 인터페이스
   • 모든 RESTful 웹 서비스 디자인의 기본
   • 서버가 표준 형식으로 정보를 전송함을 나타내며 형식이 지정된 리소스를 REST라고 표현한다.
   • 이 형식은 서버 애플리케이션에 있는 리소스 내부 표현과 다를 수 있다. 서버는 데이터를 텍스트로 저장하지만 HTML 표현 형식으로 전송할 수 있다.
     
   • 특징

     1. 요청을 리소스를 식별해야 하며 이를 위해 균일한 리소스 식별자를 사용한다.

     2. 클라이언트는 원하는 경우 리소스를 수정, 삭제하기에 충분한 정보를 리소스 표현에서 가지고 있다.

        서버는 리소스를 자세히 설명하는 메타 데이터를 전송하여 이 조건을 충족한다.

     3. 클라이언트는 표현을 추가로 처리하는 방법에 대한 정보를 수신한다.

        이를 위해 서버는 클라이언트가 리소스를 적절하게 사용할 수 있는 방법에 대한 메타 데이터가 포함된 명확한 메시지를 전송한다.

     4. 클라이언트는 작업을 완료하는 데 필요한 다른 모든 관련 리소스에 대한 정보를 수신한다.

        이를 위해 서버는 클라이언트가 더 많은 리소스를 동적으로 검색할 수 있도록 표현에 하이퍼링크를 넣어 전송한다.

2. Stateless: 무상태성

   • 서버가 이전의 모든 요청과 독립적으로 모든 클라이언트 요청을 완료하는 통신 방법을 나타낸다.
   • 클라이언트는 임의의 순서로 리소스를 요청할 수 있고 모든 요청은 다른 요청과 분리된다.
     

3. Cacheable: 캐시 가능

   • HTTP라는 기존 웹 표준을 그대로 사용하기 때문에 웹에서 사용하는 기존 인프라를 그대로 활용이 가능하고 HTTP가 가진 캐싱 기능이 적용 가능하다.

4. Code-On-Demand(optional)

   • 서버는 소프트웨어 프로그래밍 코드를 클라이언트에 전송하여 클라이언트 기능을 일시적으로 확장하거나 사용자 지정할 수 있다.
   • 웹 사이트에서 등록 양식을 작성하면 브라우저는 잘못된 실수를 강조 표시한다.
   • 서버에서 전송한 코드로 인해 이 작업을 수행할 수 있다.

5. Client-Server 구조

   • 자원이 있는 쪽이 Server, 자원을 요청하는 쪽이 Client가 된다.
     • REST Server: API를 제공하고 비즈니스 로직 처리 및 저장을 책임진다.
     • Client: 사용자 인증이나 context(세션, 로그인 정보) 등을 직접 관리하고 책임진다.
   • 서로 간 의존성이 줄어든다.

6. 계층형 구조

   • Client는 REST API Server만 호출한다.
   • REST Server는 다중 계층으로 구성될 수 있다.
     • API Server는 순수 비즈니스 로직을 수행하고 그 앞단에 보안, 로드밸런싱, 암호화, 사용자 인증 등을 추가하여 구조상의 유연성을 줄 수 있다.
     • 또한 로드밸런싱, 공유 캐시 등을 통해 확장성과 보안성을 향상시킬 수 있다.
   • PROXY, 게이트웨이 같은 네트워크 기반의 중간 매체를 사용할 수 있다.