REST란?

---

REST(Representational State Transfer)는 로이 필딩의 2000년 논문에서 처음 소개되었다. HTTP의 장점을 최대한 활용할 수 있는 아키텍처로서 REST를 소개했고 이는 HTTP 프로토콜을 의도에 맞게 디자인하도록 유도하고 있다. REST의 기본 원칙을 잘 지킨 서비스 디자인을 RESTful 이라고 표현합니다.

즉, REST는 자원을 이름으로 구분하여 해당 자원의 상태를 주고받는 모든 것을 의미합니다.

1. URI를 통해 자원을 명시하고,
2. HTTP Method(GET, POST, PUT PATCH, DELETE)를 통해
3. 해당 자원(URI)에 대한 CRUD Operation을 적용하는 것을 의미합니다.

   CRUD Operation이란?

   컴퓨터 소프트웨어가 가지는 기본적인 데이터 처리 기능인 Create(생성), Read(읽기), Update(갱신), Delete(삭제)를 일컫는 말로 REST에서 CRUD Operation 동작 예시는 다음과 같습니다.

   • Read(읽기): GET
   • Create(생성): POST
   • Update(갱신): PUT, PATCH
   • Delete(삭제): DELETE

REST API 설계 원칙과 예시

---

1. URI는 리소스를 표현해야 하고, 리소스를 식별할 수 있는 이름은 동사보다 명사를 사용하고, 대문자보다는 소문자를 사용한다.

// bad
GET /getTodos/1
GET /todos/show/1

// good
GET /todos/1

2. 리소스에 대한 행위는 HTTP 요청 Method로 표현하고 URI에 표현하지 않는다.
   HTTP 요청 Method는 클라이언트가 서버에게 요청의 종류와 목적(리소스에 대한 행위)을 알리는 방법이다.

// bad
GET /todos/delete/1

// good
DELETE /todos/1