• REST(REpresentational State Transfer): HTTP를 기반으로 클라이언트가 서버의 리소스에 접근하는 방식을 규정한 아키텍처 REST API: REST를 기반으로 서비스의 API를 구현한 것
  • REST는 HTTP/1.0과 1.1 스펙 작성에 참여했고 아파치 HTTP 서버 프로젝트의 공동 설립자인 로이 필딩(Roy Fielding)의 2000년 논문에서 처음 소개 됨
  • 발표 당시 웹이 HTTP를 제대로 사용하지 못하고 있는 상황을 보고 HTTP의 장점을 최대한 활용할 수 있는 아키텍처로서 REST를 소개했고 이는 HTTP 프로토콜을 의도에 맞게 디자인하도록 유도하고 있음
  • REST의 기본 원칙을 성실히 지킨 서비스 디자인을 “RESTful”이라 표현

REST API의 구성

• REST API는 자원(resource), 행위(verb), 표현(representations)의 3가지 요소로 구성됨
• REST는 자체 표현 구조(self-descriptiveness)로 구성되어 REST API만으로 HTTP 요청의 내용을 이해할 수 있음

REST API 설계 원칙

• REST에서 가장 중요한 기본적인 원칙:
  1. URI는 리소스를 표현하는 데 집중함
  2. 행위에 대한 정의는 HTTP 요청 메서드를 통해 함

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

   • URI는 리소스를 표현하는 데 중점을 두어야 함
   • 리소스를 식별할 수 있는 이름은 동사보다는 명사를 사용함
     • 이름에 get 같은 행위에 대한 표현이 들어가서는 안 됨

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

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

   • HTTP 요청 메서드는 클라이언트가 서버에게 요청의 종류와 목적(리소스에 대한 행위)을 알리는 방법
   • 주로 5가지 요청 메서드를 사용하여 CRUD를 구현함

   HTTP 요청 메서드	종류	목적	페이로드
   GET	index/retrieve	모든/특정 리소스 취득	X
   POST	create	리소스 생성	O
   PUT	replace	리소스의 전체 교체	O
   PATCH	modify	리소스의 일부 수정	O
   DELETE	delete	모든/특정 리소스 삭제	X

   • 리소스에 대한 행위는 HTTP 요청 메서드를 통해 표현하며 URI에 표현하지 않음
     • eg. 리소스를 취득하는 경우에는 GET, 리소스를 삭제하는 경우에는 DELETE를 사용하며 리소스에 대한 행위를 명확히 표현

   # bad
   GET /todos/delete/1
   
   # good
   DELETE /todos/1
   

JSON Server를 이용한 REST API 실습

• HTTP 요청을 전송하고 응답을 받으려면 서버가 필요함. JSON Server를 사용해 가상 REST API 서버를 구축하여 HTTP 요청을 전송하고 응답을 받는 실습을 진행해보자.

JSON Server 설치

• JSON Server: json 파일을 사용하여 가상 REST API 서버를 구축할 수 있는 툴