[WEB] REST API란

REST 🔎

• Representational State Transfer의 약자
• 웹상의 자원(문서, 이미지, 영상 등)을 자원명으로 표시하여 상태를 주고 받는 규칙
• HTTP URI를 통해서 자원을 명시하고, HTTP Method를 통해서 자원에 대한 CRUD 처리하는 방식
• URI(URL) 표기하는 방식 중 하나이다.
• URI와 HTTP Method 를 결합한 것이 REST API이다.

 

URI 표기 방식 비교🔎

예를들어 게시판을 구현할 때, 이전 방식에서는 'http://localhost/board/list.do' 으로 동사를 이용해서 행위하는 것을 표현했다.

- 이전 방식

페이지	요청 메서드	요청 주소
목록보기	GET	http://localhost/board/list.do
추가하기	POST	http://localhost/board/add.do
수정하기	POST	http://localhost/board/edit.do
삭제하기	POST	http://localhost/board/del.do

 

이 URI 방식은 가독성 및 다른 여러 문제점이 많아 분분한 의견이 많았다.

체계적으로 표시하자는 의견이 많아 탄생한 것이 REST 방식이다.

 

- REST 방식

더이상 주소에 동사를 넣지않는다. 단, 요청 메서드를 GET, POST 뿐만 아니라 PUT, DELETE 등 여러가지를 사용한다.

페이지	요청 메서드	요청 주소
목록보기	GET	http://localhost/board
추가하기	POST	http://localhost/board
수정하기	PUT	http://localhost/board/1
삭제하기	DELETE	http://localhost/board/1

 

 

---

REST API 설계 규칙🔎

1. URI 마지막 단어에 자원명을 표시한다.

• http://localhost/board
• CRUD는 요청 메서드를 통해 인식하고 마지막 단어로 자원명을 인식한다. 
• 단수형, 복수형은 자유롭게 사용한다.

2. URI에 동사를 표시하지 않는다.

3. HTTP Method를 사용하여 2번 대신 행동(동사)을 표현한다. ★

• GET : 자원 요청
• POST : 자원 전달 및 서버측 생성 요청
• PUT : 자원 전달 및 수정(기존 자원을 삭제 후 새로 생성한다.) > 전체(모든 컬럼)이 수정된다.
• PATCH : 자원 전달 및 수정(일부 수정 가능)
• DELETE : 자원 삭제

4. 구분자는 '/'를 사용한다.

5. URL의 마지막은 '/'를 적지 않는다.

• 톰캣에서는 마지막에 '/'를 자동으로 붙여줘서 우리가 '/'를 붙여도 에러가 나지않지만, REST API를 이용할 때는 붙이면 안된다.

6. URI에는 '-' 사용이 가능하다.

• 권장하지 않는다.

7. URI에는 '_' 사용하지 않는다.

• 공백인지 언더라인인지 구분이 잘 가지 않아 사용을 지양한다. 

8. URI은 소문자로만 작성한다.

9. 확장자를 작성하지 않는다.

• URI가 자원명으로 끝나기 때문에 작성하지 않는다.

 

---

 

SSR와 CSR : 페이지 렌더링 방식🔎

SSR(서버 사이드 렌더링)과 CSR(클라이언트 사이드 렌더링)은 웹 애플리케이션에서 페이지를 렌더링하는 두 가지 주요 접근 방식이다.

- SSR

• Server Side Rendering의 약자. 
• 브라우저(클라이언트)에서 페이지를 요청하면 서버에서는 작업 끝에 html 페이지를 생성한다.
• Html 페이지를 만드는 작업을 렌더링한다고 하는데 서버가 렌더링을 담당한다.
• 가장 오래되었으면 아직까지 메인 방식이다.  

 

 

 

- CSR

• Client Side Rendering의 약자.
• 브라우저 자체적으로 페이지를 생산하며 JavaScript를 사용하여 추가적인 데이터를 서버로 요청하고 동적으로 페이지를 렌더링한다.
• 브라우저 자체에서 페이지를 생산할 수 있는 능력이 있으므로 CRUD 만을 전문적으로 하는 서버를 필요로 한다. 이런 서버를 REST 서버라고 한다.
  
  
• 최근에 상대적으로 많이 늘어나고 있다. 리액트, Vue.js 가 CSR 방식이다.