RESTful 아키텍처, 서비스

2021. 3. 23. 02:03 기타 정보/IT 관련 정보|뉴스

Representational State Transfer의 약자로, 로이 필딩(HTTP 프로토콜 주요 저자)이 제창했다.

1. REST 아키텍처의 조건

  • 클라이언트/서버 : 클라이언트의 요청과 서버의 응답 기반
  • 상태 없음 : 클라이언트의 상태(다른 URL에 있다던지)와 관계없이 요청으로만 응답
  • 캐시 : 클라이언트는 서버의 응답을 캐시한다. 같은 요청마다 계속 다운로드받을 수는 없으므로.. 네트워크 비용 절감
  • 계층화 시스템 : 서버는 다양한 형태의 중간 계층을 이용해서 확장할 수 있다. 클라이언트는 서버의 계층에 무관하게 통신할 수 있다.
  • Code on Demand : 리소스를 다룰 수 있는 코드 전송(JS 등)
  • 인터페이스 일관성 : 시스템 구조를 단순화시키고 작은 단위로 분리해서 독립적으로 개선하고 확장할 수 있다.

2. REST 인터페이스 원칙

  • 자원 식별 : 개별 리소스를 식별할 수 있어야 한다.
  • 메세지로 리소스 조작 : 메세지에 작성한 리소스를 다루는 정보를 이용해서 리소스를 얻어오거나 리소스를 조작한다.
  • 자기 서술적 메세지 : 요청과 응답 메세지에는 메세지를 처리할 수 있는 정보를 포함한다.
  • 하이퍼미디어 : 하이퍼링크를 이용해서 유기적으로 연결된 문서로 쉽고 간단하게 정보를 접할 수 있다.

3. REST 서비스 설계

인터페이스 설계

  • 간단하고 직관적인 API
  • 리소스를 다루는 행위는 HTTP 메소드 사용(get, post, put, delete)
  • api 버전업 고려
  • 명사형 단어 사용 권장
  • 목록 형태의 리소스를 다루는 API는 복수형 명사
  • 목록에서 특정 조건으로 필터링 : 쿼리 문자열 이용



출처: https://sjh836.tistory.com/86?category=687142 [빨간색코딩]