Spring REST API란?, 특징, 설계 규칙

REST API는 대중적으로 가장 많이 사용되는 애플리케이션 인터페이스이다. 이를 통해 클라이언트는 서버에 접근하고 자원을 조작할 수 있게 된다.

REST란?

'Representational State Transfer'의 약자로, 월드 와이드 웹(www)과 같은 분산 하이퍼미디어 시스템 아키텍처의 한 형식이다. 주고받는 자원(Resource)에 이름을 규정하고 URL에 명시해 HTTP 메서드(GET, POST, PUT, DELETE)를 통해 해당 자원의 상태를 주고받는 것을 의미한다.

REST API란?

API는 'Application Programming Interface'의 약자로, 애플리케이션에서 제공하는 인터페이스를 의미한다. API를 통해 서버 또는 프로그램 사이를 연결할 수 있게 한다. 즉 REST API는 RSET 아키텍처를 따르는 시스템,애플리케이션 인터페이스라고 볼 수 있다. REST 아키텍처를 구현하는 웹 서비스를 'RESTful'하다~ 라고 표현하기도 한다.

REST의 특징

• 유니폼 인터페이스
  : '일관된 인터페이스'를 의미한다. 즉, REST 서버는 HTTP 표준 전송 규약을 따르고 있어 어떤 프로그래밍 언어로 만들어졌느냐와 상관없이 플랫폼 및 기술에 종속되지 않고 타 언어, 플랫폼, 기술 등과 호환해 사용할 수 있다는 것이다.

• 무상태성
  : 무상태성이란, 서버에 상태 정보를 따로 보관하거나 관리하지 않는다는 것이다. 서버는 클라이언트가 보낸 요청에 대해 세션이나 쿠키 정보를 별도로 보관하지 않는다. 그렇기에 한 클라이언트가 여러 요청을 봬든 여러 클라이언트가 하나씩의 요청을 보내든 개별적으로 처리를 하게 된다. 이로인해 서버가 불필요한 정보를 관리하지 않아 비즈니스 로직의 자유도가 높고 설계가 단순하다.

• 캐시 가능성
  : REST는 HTTP 표준을 그대로 사용하여 HTTP의 캐싱 기능을 적용할 수 있다. 이 기능을 위해 응답과 요청이 모두 캐싱 가능한지(Cacheable) 명시가 필요하고, 캐싱이 가능한 경우에는 클라이언트에서 캐시에 저장해두고 같은 요청에 대해서는 해당 데이터를 가져다 사용한다. 이 기능을 사용하면 서버의 트랜잭션 부하가 줄어 효율적이며 사용자 입장에서는 선능이 개선된다.

• 레이어 시스템
  : REST 서버는 네트워크 상의 여러 계층으로 구성될 수 있다. 다만 서버의 복잡도와 관계없이 클라이언트는 서버와 연결되는 포인트만 알면 된다.

• 클라이언트-서버 아키텍처
  : REST 서버는 API를 제공하고 클라이언트는 사용자 정보를 관리하는 구조로 분리해 설계한다. 이 구성은 서로에 대한 의존성을 낮추는 기능을 하게 된다.

REST의 URI 설계 규칙

• URI의 마지막에는 '/'를 포함하지 않는다.
  -> http://success.com/service(O), http://success.com/service/(X)

• 언더바(_)는 사용하지 않는다. 대신에 하이픈(-)을 사용한다.
  -> 하이픈도 리소스의 이름이 길어지면 사용한다
  -> ex) http://success.com/hwi-bin

• URL에는 행위(동사)가 아닌 결과(명사)를 포함한다.
  -> http://success.com/service/333 (O), http://success.com/delete-service/333 (X)
  -> 행위는 HTTP 메서드로 표현할 수 있어야 한다.

• URI는 소문자로 작성한다.
  -> URI 리소스 경로에는 대문자 사용을 피하는 것이 좋다.
  -> 일부 웹 서버의 운영체제는 리소스 경로 부분의 대소문자를 다른 문자로 인식할 수 있기 때문이다.

• 파일의 확장자는 URI에 포함하지 않는다.
  -> HTTP에서 제공하는 Accept 헤더를 사용하는 것이 좋다.