REST API와 RESTful API 📇

REST API와 RESTful API는 웹 서비스 설계와 통신 방식에서 자주 언급되는 개념 중 하나다.

 

REST API

REST API는 REpresentational State Transfer라는 소프트웨어 아키텍처 스타일을 기반으로 만든 웹 API (Application Programming Interface)이다. 주로 클라이언트와 서버 간의 데이터 전송에 사용된다.
REST - HTTP URI를 통해 자원을 명시하고 HTTP 메서드(POST, GET, PUT, DELETE)를 통해 해당 자원에 대한 CRUD를 적용하는 것을 말한다.

 

 

핵심 개념

• 클라이언트-서버 구조: 클라이언트와 서버는 독립적으로 동작하며, 서버는 리소스(데이터)를 제공하고 클라이언트는 이를 요청
• 무상태(Stateless): 각 요청은 독립적으로 처리되며, 서버는 이전 요청의 상태를 저장 X
• 표현(Representation): 리소스는 JSON, XML 등의 형식으로 표현되어 전송
• 표준 HTTP 메서드 사용

GET /users/123

ID가 123인 사용자 정보를 조회

 

 

RESTful API

RESTful API는 위에서 설명한 REST의 원칙들을 제대로 지키는 API를 일컫는다. 즉, REST 아키텍처 스타일을 충실히 구현한 API가 RESTful하다고 표현한다.

 

RESTful API의 조건

• 리소스 중심의 URI 사용
• HTTP 메서드를 의미에 맞게 사용
• 무상태성 준수
• 캐시 처리 가능성
• 계층화 구조

POST /getUserInfo?id=123

RESTful하지 않은 API

리소스가 아닌 동작(함수)에 초점을 맞췄고, POST를 조회용으로 사용하는 등 RESTful하지 않음