36. REST (Representational State Transfer) API

• REST : 웹의 장점을 최대한 활용할 수 있는 아키텍쳐. HTTP 프로토콜을 의도에 맞게 디자인 하도록 유도한다.
• RESTful : REST의 기본 원칙을 성실히 지킨 서비스 디자인

#1. REST API 중심 규칙

URI는 자원을 표현하는 데에 집중하고 행위에 대한 정의는 HTTP Method를 통해 하는 것이 REST한 API를 설계하는 중심 규칙이다.

 

1. URI는 정보의 자원을 표현해야 한다

• 리소스명은 동사보다는 명사를 사용한다.
• URI는 자원을 표현하는데 중점을 두어야 한다.
• get같은 행위에 대한 표현이 들어가서는 안된다.

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

# good
GET /todos/1

 

2. 자원에 대한 행위는 HTTP Method(GET, POST, PUT, DELETE)로 표현한다

# bad
GET /todos/delete/1

# good
DELETE /todos/1

 

#2. HTTP Method

• 5가지의 Method를 사용하여 CRUD를 구현

#3. REST API의 구성

• 자원(Resource), 행위(Verb), 표현(Representations) 3가지의 요소로 구성