REST / REST API / RESTful API

1. REST 란?

REST (REpresentational State Transfer)의 약어로 네트워크 아키텍처 원리의 모음이다.

'네트워크 아키텍처 원리' 란 자원을 정의하고 자원에 대한 주소를 지정하는 방법 전반을 일컫는다.

말이 어렵다. 쉽게 말하자면 웹에서 Client와 Sever의 통신 방법중 하나이다. 다만 그 통신 방법에 특정한 규칙을 정한 게 REST라고 할 수 있다.

REST 구성 요소

HTTP URI (Uniform Resource Identifier)를 통해 자원(Resource)을 명시하고
HTTP Method(POST, GET, PUT, DELETE)를 통해 해당 자원에 대한 CRUD(Create, Read, Update, Delete) 연산을 수행한다.
Post - Create, Get - Read, Put - Update, Delete - Delete
Server 와 Client가 데이터를 주고받는 방식에는 json, xml, text, rss 등이 있고, 이 중에 Key와 Value를 사용하는 json 방식을 주로 채택

REST 특징

1. Uniform Interface(균일한 인터페이스)

2. Client - Server 구조

3. Stateless (무상태성)

HTTP 프로토콜이 Stateless Protocol인 것과 마찬가지로 REST도 무상태성을 갖는다.
클라이언트의 세션과 쿠키 같은 Context를 서버에 저장하지 않으므로 서버 구현이 단순해진다.
클라이언트의 요청을 각각 별개의 것으로 인식하며 단순 처리하게 해 주면 된다.
- 이전 요청이 다음 요청의 처리에 연관되지 않음
- DB에 의한 변경은 허용

4. Cacheable (캐싱 가능성)

서버 측의 확장성 증가와 함께 클라이언트 측의 성능 향상을 동시에 얻는다.
- 가급적이면 리소스를 클라이언트 또는 서버 측에서 캐싱할 수 있어야 한다.
- 서버 응답에는 전달된 리소스에 대해 캐싱이 허용되는지 여부에 대한 정보도 포함되어야 한다.
웹 표준 HTTP 프로토콜을 그대로 사용하므로 웹에서 사용하는 기존의 인프라를 그대로 활용할 수 있다.
- HTTP에서 사용하는 Last-Modified나 E-Tag를 사용해 구현 가능
대량의 요청을 효율적으로 처리하기 위해 캐시가 요구됨 (대량의 요청을 효율적으로 처리 가능)

5. Layerd System (계층 구조)

6. Code - On - Demand (optional)

REST API는 일반적으로 정적 리소스를 전송하지만, 특정한 경우에는 응답에 실행코드 (ex. Java 애플릿)를 포함할 수 있다. 이러한 경우 코드는 요청 시간에만 실행되어야 한다.
Server로부터 스크립트를 받아서 클라이언트에서 실행한다.
반드시 충족할 필요는 없다.

보너스. Self-Descriptiveness (자체 표현)

슬래시 구분자( / )는 계층 관계를 나타내는 데 사용한다.
- 예) http://restapi.example.com/members/students
URI 마지막 문자로 슬래시 ( / )를 포함하지 않는다.
- 예) http://restapi.example.com/members/students/
밑줄 ( _ )을 사용하지 않고, 하이픈 ( - ) 을 사용한다.
URI 경로에는 소문자를 사용한다.
파일 확장자는 URI에 포함하지 않는다. (*.txt, *.png 등)
- 예) http://restapi.example.com/members/students/13/photo.jpg (X)
- Accept header를 사용
  - GET / members/students/13/photo HTTP/1.1 Host: restapi.example.com Accept: image/jpg (O)
URI는 정보의 자원을 표현해야 한다. (리소스 명은 동사가 아닌 명사를 사용)
자원의 행위는 HTTP 메소드(GET, POST, PUT, DELETE)로 표현한다.

Reference