[modern JS Deep Dive] - 44장 . REST API

---

RESTful

• 로이 필딩이 HTTP의 장점을 최대한 활용할 수 있는 아키텍쳐로서 REST를 소개했고, HTTP 프로토콜을 의도에 맞게 디자인 하도록 유도하고 있다. REST 의 기본 원칙을 성실히 지킨 서비스 디자인을 RESTful 이라고 표현한다.
• 결론 : REST는 HTTP 를 기반으로 클라이언트가 서버의 리소스에 접근하는 방식을 규정한 아키텍쳐고, REST API 는 REST를 기반으로 서비스 API 를 구현한 것을 의미한다.

---

REST API의 구성

• REST API는 자원, 행위, 표현 3가지 요소로 구성된다.
• REST는 자체 표현 구조로 구성되어 REST API만으로 HTTP 요청의 내용을 이해할 수 있다.

구성 요소	내용	표현 방법
자원	자원	URI(엔드포인트)
행위	자원에 대한 행위	HTTP 요청 메서드
표현	자원에 대한 행위의 구체적 내용	페이로드

---

REST API 설계 원칙

• URI 는 리소스를 표현하는데 집중하고, 행위에 대한 정의는 HTTP 요청 메서드를 통해 하는 것이 RESTful API를 설계하는 중심 규칙이다.

1. URI는 리소스를 표현해야 한다.

• 리소스를 식별할수 있는 이름은 동사보다는 명사를 사용한다.

2. 리소스에 대한 행위는 HTTP 요청 메서드로 표현한다.

• HTTP 요청 메서드는 클라이언트가 서버에게 요청의 종류와 목적(리소스에 대한 행위)를 알리는 방법이다.