[Backend] REST와 RESTful API

REST란?

먼저 REST (Representational State Transefer) 란?

웹 서비스가 어떻게 동작해야 하는지에 대한 아키텍처 스타일 또는 설계 원칙이다.

쉽게 말해 웹에서 데이터를 주고받는 규칙을 의미한다.

 

REST는 클라이언트와 서버 간의 상호작용을 규정하며,

기본적으로 웹의 기존 기술과 HTTP 프로토콜을 그대로 활용하기 때문에 웹의 장점을 최대한 활용할 수 있는

아키텍처 스타일이다.

 

자원을 이름(자원의 표현)으로 구분해 해당 자원 상태(정보)를 주고받는 모든 것을 의미한다.

 

어떤 자원에 대해 CRUD 연산을 수행하기 위해서 URI (Resource)로 GET, POST 등의 방식 (Method)을 사용하여

요청을 보내며, 요청을 위한 자원은 특정한 형태(Representation of Resource)로 표현한다.

 

 

 

REST API란?

REST 아키텍처 스타일을 따르는 웹 API를 의미한다.

 

REST API 디자인 시

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

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

 

💡 HTTP Method

CRUD	Method
Create (생성)	POST
Read (조회)	GET
Update (수정)	PUT
Delete (삭제)	DELETE

 

 

 

✨ REST API의 설계 규칙

• URI는 명사를 사용해야 한다. (ex. /getUsers, /createNewUser 같은 동사 사용 xx)
• 슬래시(/)로 계층 관계를 표현한다.
• URI 마지막 문자로 슬래시를 포함하지 않는다.
• 언더바(_)를 사용하지 않고 하이픈(-)을 사용한다.
• URI는 소문자로만 구성한다.
• HTTP 응답 상태 코드를 사용한다.
  • 1xx (정보), 2xx (성공), 3xx (리다이렉션), 4xx (클라이언트 오류), 5xx (서버 오류)
• 파일 확장자는 URI에 포함하지 않는다. (ex. /photo.jpg 형식 xxx)

 

REST API와 RESTful API의 차이?

REST의 설계 규칙을 잘 지켜서 설계된 API를 RESTful한 API라고 한다.

==> REST의 원리를 잘 따르는 시스템을 RESTful이란 용어로 지칭한다.