[API]REST에 대해 알아보자

ddanglehee·2022년 10월 19일

CS

목록 보기
1/2

📌 REST란?

REpresentational State Transfer의 약자로, 자원을 이름으로 구분하여 해당 자원의 상태를 주고받는 모든 것을 의미합니다.
HTTP URI(Uniform Resource Identifier)를 통해 자원(Resource)을 명시하고, HTTP Method를 통해 해당 자원을 처리(CRUD)한다.

✍️ HTTP란 무엇인가?

HyperText Transfer Protocol의 약자로, 80번 포트를 사용하여 웹 상에서 정보를 주고받을 수 있는 프로토콜이다.
HTTP의 등장 초기에는 주로 텍스트를 전송하기 위한 프로토콜이었지만, 점차 기능이 늘어가면서 다양하게 사용되는 프로토콜이 되었다.

🙂 특징

  1. Connectionless : 용건이 있을 때만 소켓을 사용해서 연결 -> Server에 여유가 생겨서 더 많은 접속에 대해 대응할 수 있다.
  2. Stateless : Server가 Client의 상태를 기억하지 못한다. -> Server가 Client를 기억해야 하는 경우 쿠키나 세션, 토큰 등을 사용한다.

⚙️ 동작 방식

  1. Request : client가 server에 HeaderBody로 이루어진 메세지를 요청
  2. Response : server에서 client가 보낸 request를 처리하고 응답 코드와 함께 결과를 반환

🛠 HTTP Method

GET : 서버에 자원 요청
HEAD : GET과 같지만 body를 포함하지 않음
POST : 클라이언트에서 요청한 URL에 body의 내용으로 새로운 자원 생성
PUT : 클라이언트가 요청한 내용으로 서버에 있는 자원을 수정 (HTTP 자체에는 인증 기능이 없다는 보안상의 문제로 REST를 사용할 때 이용한다.)
DELETE : 서버에 있는 자원 삭제
CONNECT : 요청한 자원에 대해 양방향 연결을 수립 예) SSL로 암호화하여 프록시에 터널링 요청
OPTIONS : 서버가 어떤 HTTP 메소드를 지원하는지 물어봄
TRACE : 메세지의 변조 여부 확인을 위해, 서버가 수신한 클라이언트의 메세지 반환 (보안상의 문제 때문에 보통 사용 잘 안함)
PATCH : 서버에 있는 자원의 일부만을 수정 (vs. PUT은 자원 전체를 수정)

📍 REST의 구성 요소

1. 자원(Resource): URI

  • 모든 자원에 고유한 ID가 존재하는데, 이것은 HTTP URI이다.(ex. /user/1)
  • 자원은 Server에 존재한다.
  • 클라이언트는 URI를 이용해서 자원을 지정하고, 해당 자원의 상태(정보)에 대한 조작을 Server에게 요청한다.

2. 행위(Verb): HTTP Method

  • HTTP 프로토콜의 Method를 사용한다.

3. 표현(Representation)

  • 클라이언트가 자원의 상태(정보)에 대한 조작을 요청하면, Server는 이에 적절한 응답(Representation)을 보낸다.
  • 하나의 자원은 JSON, XML, TEXT, RSS 등 여러 형태의 Representation으로 나타내어질 수 있다.

📍 REST의 장단점

👍 장점

  1. HTTP 프로토콜의 인프라를 그대로 사용하기 때문에, REST API 사용을 위한 별도의 인프라를 구축할 필요가 없다.
  2. HTTP 프로토콜의 표준을 따르는 모든 플랫폼에서 사용할 수 있다.
  3. REST API 메세지가 의도하는 바를 명확하게 나타내므로 쉽게 파악할 수 있다.
  4. 서버와 클라이언트의 역할을 명확하게 분리한다. (클라이언트는 서버가 어떤 작업을 하는지 몰라도 된다.)

👎 단점

  1. HTTP 메소드를 사용하기 때문에 제공하는 메소드 형태가 제한적이다.
  2. 표준이 없다. (API 디자인 가이드가 없다.) -> 관리가 어려워짐

📍 REST의 특징

1. Server-Client 구조

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

2. Stateless(무상태)

  • HTTP 프로토콜은 Stateless Protocol이므로 REST도 무상태성을 갖는다.
  • Client의 context를 Server에 저장하지 않으므로 구현이 단순해진다.
  • Server는 각각의 요청을 독립적으로 처리한다.
    • 이전 요청이 다음 요청의 처리에 연관되어서는 안된다. (DB 관련은 제외)
    • Server의 처리 방식에 일관성을 부여하고 부담이 줄어든다.

3. Cacheable(캐시 처리 가능)

  • 웹 표준 HTTP 프로토콜을 그대로 사용하기 때문에, HTTP의 캐싱 기능을 적용할 수 있다.
    • Last-Modified태그나 E-Tag를 이용하면 캐싱 구현이 가능하다.
  • 캐시 사용을 통해 REST Server에 트랜잭션이 발생하지 않기 때문에 성능(응답시간 등), 서버의 자원 이용률을 향상시킬 수 있다.

4. Layered System(계층화)

  • REST Server는 다중 계층으로 구성될 수 있다.
    • Server는 순수 비즈니스 로직을 수행하고, 그 앞단에 보안, 로드밸런싱, 암호화, 사용자 인증 등을 추가하여 구조상의 유연성을 줄 수 있다. -> 확장성, 보안성 향상
    • Client는 대상 Server와 직접 통신하는 건지, 중간 매체와 통신하는 건지 알지 못한다.
  • Proxy, Gateway 같은 네트워크 기반의 중간 매체를 사용할 수 있다.

5. Uniform Interface(인터페이스 일관성)

  • HTTP 표준 프로토콜을 따르는 모든 플랫폼에서 사용이 가능하다.
  • URI로 지정한 Resource에 대한 조장을 통일되고 한정적인 인터페이스로 수행한다.

📌 REST API란?

REST를 기반으로 서비스의 API를 구현한 것이다.

✍️ API란 무엇인가?

Application Programming Interface의 약자로,
말 그대로 애플리케이션 프로그램들이 인터페이스를 통해서 서로 통신(요청, 응답)할 수 있게 도와주는 매커니즘이다.


📚 참고

REST API | PoiemaWeb
REST란? REST API란?
그림으로 배우는 HTTP & Network

profile
잊고싶지 않은 것들을 기록합니다✏️

0개의 댓글