RESTful API

REST는 Representational state transfer의 약자로 World Wide Web과 같은 분산 하이퍼미디어 시스템에서 운영되는 소프트웨어 아키텍처 스타일이다.

HTTP 프로토콜을 의도에 맞게 정확히 활용하여 디자인하도록 유도하고 있기 때문에 디자인 기준이 명확해지며, 의미적인 범용성을 지니므로 중간 계층의 컴포넌트들이 서비스를 최적화하는 데 도움이 된다. REST의 기본 원칙을 충실히 지킨 서비스 디자인을 “RESTful” 이라고 표현한다.

REST에서 가장 중요하며 기본적인 규칙은 아래 두 가지이다.

• URI는 정보의 자원을 표현해야 한다.
• 자원에 대한 행위는 HTTP Method로 표현한다.

HTTP Method 사용의 예는 아래와 같다.

Verb	Action	Path	Used for
GET	index	/books	모든 서적 리스트 조회
GET	retrieve	/books/:id	특정 서적 조회
POST	create	/books	신규 서적 생성
PUT	replace	/books/:id	특정 서적 갱신(존재하지 않으면 생성)
PATCH	update	/books/:id	특정 서적 갱신
DELETE	delete	/books	모든 서적 삭제
DELETE	delete	/books/:id	특정 서적 삭제