REST, RESTful API, REST 제약 조건

REST란

REST(Representational State Transfer)란 API 작동 방식에 대한 조건을 부과하는 소프트웨어 아키텍쳐이다. REST는 인터넷과 같은 복잡한 네트워크에서 통신을 관리하기 위한 지침으로 만들어졌다.

RESTful API란

RESTful API는 REST 아키텍처를 따르는 API다. 이는 시스템이 RESTful 방식으로 HTTP를 통해 통신할 수 있도록 하는 인터페이스이다. RESTful API는 단순하고 확장 가능하며 상태 비저장되도록 설계되었다. 

RESTful API는 일반적으로 URI로 식별되는 리소스에 대한 작업에 표준 HTTP 메서드(GET, POST, PUT, DELETE)를 사용한다.  클라이언트와 서버 간에 교환되는 데이터는 JSON 또는 XML 형식인 경우가 많다.

REST 제약 조건

1. 무상태(Stateless)

각 요청 간 클라이언트의 요청 상태가 서버에 저장되어서는 안된다. 즉, 각 요청에는 그 요청을 이해하는 데 필요한 모든 정보가 포함되어 있어야 한다.

2. 캐시 처리 가능(Cacheable)

클라이언트는 응답을 캐싱할 수 있어야 한다. 

3. 클라이언트/서버 구조

아키텍처를 단순화시키고 작은 단위로 분리(decouple)함으로써 클라이언트-서버의 각 파트가 독립적으로 개선될 수 있도록 해준다.

4. 계층화(Layered System)

계층화된 시스템 아키텍처에서 클라이언트는 클라이언트와 서버 사이의 다른 승인된 중개자에게 연결할 수 있으며 여전히 서버로부터도 응답을 받는다. 서버는 요청을 다른 서버로 전달할 수도 있다. 클라이언트 요청을 이행하기 위해 함께 작동하는 보안, 애플리케이션 및 비즈니스 로직과 같은 여러 계층으로 여러 서버에서 실행되도록 RESTful 웹 서비스를 설계할 수 있다. 이러한 계층은 클라이언트에 보이지 않는 상태로 유지된다. 

5. Code on demand (optional)

요청 시 서버에서 클라이언트로 실행 가능한 코드를 전송하여 클라이언트 기능을 확장하는 기능이다.  예를 들어, 웹 사이트에서 등록 양식을 작성하면 브라우저는 잘못된 전화번호와 같은 실수를 즉시 강조 표시한다. 서버에서 전송한 코드로 인해 이 작업을 수행할 수 있다.

6. 인터페이스 일관성

일관적인 인터페이스로 분리되어야 한다. 제약 조건은 다음과 같다.

- 리소스 식별: 리소스는 URI(Uniform Resource Identifier)로 식별된다.

- 표현을 통한 리소스 조작: 클라이언트가 보낸 표현(ex. JSON 또는 XML)을 통해 리소스를 조작할 수 있다.

- 자기 설명적 메시지: 클라이언트에서 서버로, 서버에서 클라이언트로의 각 메시지에는 메시지 처리 방법을 설명하는 데 충분한 정보가 포함되어야 한다.

 

 

 

 

 

---

참고 자료

https://aws.amazon.com/ko/what-is/restful-api/