REST와 REST API 개념 알기

REST(Representational State Transfer)란?

말 그대로, 자원(Resource)의 표현(Representation)에 의한 상태 전달(State Transfer)이다.

 

여기서 자원이란? 해당 소프트웨어가 관리하는 모든 것 (문서,그림,데이터,해당 소프트웨어 자체 등)

여기서 표현이란? 그 자원을 표현하기 위한 이름

여기서 상태전달이란? 데이터가 요청되는 시점에 자원의 상태를 전달하는 것.

 

풀어 설명하자면, 자원을 이름으로 구분하여 해당 자원의 상태를 주고 받는 모든 것을 의미한다.

 

쉽게 말해, 

웹에 존재하는 모든 자원에 고유한 URI를 부여해 활용하는 것으로, 자원을 정의하고 자원에 대한 주소를 지정하는 방법론을 의미한다.

REST의 구성요소

• 자원(Resocurce) = URI

    - 모든 자원에는 고유한 ID가 존재하고, 이 자원은 server에 존재한다.

    - 자원을 구별하는 ID는 'team/1' 과 같은 HTTP URI이다.

    - Client는 URI를 이용해 자원을 지정하고 해당 자원의 상태에 대한 조작을 server에 요청한다.

• 행위(Verb) = Method

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

      (HTTP란? 참고_ https://doglovedeveloper.tistory.com/28?category=517064)

• 표현(Representation)

    - Client와 Server가 데이터를 주고 받는 형태로 JSON, XML, TEXT, RSS 등이 있다.

    - JSON, XML 을 통해 데이터를 주고 받는 것이 일반적이다.

 

REST의 6원칙 (특징)

1. Client-Server (서버-클라이언트 구조)

    자원이 있는 Server , 자원을 요청하는 Client의 구조를 가진다.

    확실한 역할 구분으로 서로간의 의존성을 줄인다.

2. Uniform interface (인터페이스 일관성)

    URI로 지정한 Resource에 대한 요청을 통일되고, 한정적인 인터페이스로 수행한다.

    HTTP 표준에 따르는 모든 플랫폼에서 사용이 가능하다.

3. Stateless (무상태)

    HTTP는 Stateless Protocol이므로 REST역시 무상태성을 가진다.

    Client의 context를 server에 저장하지 않는다.

    Server는 각각의 요청을 완전히 별개의 것으로 인식하고 처리한다.

4. Cacheable (캐시 처리 기능)

    웹 표준 HTTP 프로토콜을 그대로 사용하므로, 웹에서 사용하는 기존 인프라를 그대로 활용할 수 있다.

    즉, HTTP가 가진 특징 중 하나인 캐싱 기능을 적용 할 수 있다.

5. Layered System (계층 구조)

    REST Server는 다중 계층으로 구성 될 수 있다.

    보안, 로드 밸런싱, 암호화 등을 위한 계층을 추가하여 구조를 변경 할 수 있으며,

    Proxy, Gateway와 같은 네트워크 기반의 중간매체를 사용 할 수 있다.

6. Self-Descriptiveness (자체 표현 구조)

    REST API 메시지만 보고도 쉽게 이해 할 수 있도록 직관적으로 이해가 가능한 자체 표현 구조.

 

REST API 란?

먼저 API란?

Application Programming Interface의 약어로,

client, server와 같은 서로 다른 프로그램에서 요청과 응답을 주고 받을 수 있게(통신 할 수 있도록) 만든 체계를 뜻한다.

 

그렇다면 REST API란?

(REpresentational State Transfer)+(Application Programming Interface)

REST의 특징을 기반으로 서비스 API를 구현한 것.

종종 REST API를 RESTful한 API 라고도 한다.

REST의 설계 규칙을 잘 지켜 설계된 API를 RESTful한 API라고 한다.

즉, REST의 원리를 잘 따르는 시스템을 RESTful이란 용어로 지칭하기도한다.

 

참고자료 : https://dev-coco.tistory.com/97

 

* 좋은 REST API의 원칙

  - 가능한 (복수형)명사로 작성

  - 자료 하나당 하나의 URI

  - 띄어쓰기는 -(대시)를 사용

  - 파일 확장자는 쓰지 않는다

  - 하위 문서(계층관계)를 나타낼때는 /(슬래시)를 사용

  - 영어 소문자만 사용 (대문자X)