REST API란?

🤔 REST API란?

REST API, RESTful API, 많이 들어봤지만 너무나도 추상적으로 느껴져서 설명을 하려니 어렵게 느껴져서 다시 간단히 정리해보려 한다.

 

먼저 API란 Application Programming Interface의 약자로, 애플리케이션이나 디바이스가 서로간 연결하여 통신할 수 있는 방법을 정의하는 규칙 세트라고 생각하면 된다. 즉, 하나의 애플리케이션이나 서비스가 다른 애플리케이션이나 서비스 내의 리소스에 액세스할 수 있게 해주는 매커니즘이다.

 

REST API에서 REST는 REpresentational State Transfer의 약자로, REST한 아키텍처 스타일의 디자인 원칙을 준수하는 API를 의미한다. 그래서 RESTful API라고도 하는 것. REST의 핵심 원칙은 무엇일까?

 

🤔 REST 핵심 원칙

1. 균일한 인터페이스

요청이 어디서 오는지와 무관하게 동일한 리소스에 대한 모든 API 요청은 동일하게 보여야 함. 하나의 URI(Uniform Resource Identifier)에 속함을 보장해야함

 

2. 클라이언트 - 서버 디커플링

클라이언트와 서버 애플리케이션은 서로 완전히 독립적이어야 함. 클라이언트 애플리케이션이 알아야 하는 유일한 정보는 요청된 리소스의 URI. 다른 방식으로 서버 애플리케이션과 상호작용 불가. 또한, 서버 애플리케이션은 HTTP를 통해 요청된 데이터에 전달하는 것 말고 클라이언트 애플리케이션을 수정하지 않아야 함

 

3. Stateless

상태 없음. 각 요청에서 이의 처리에 필요한 모든 정보를 포함해야 함. REST API는 서버 측 세션을 필요로 하지 않음.

 

4. 캐싱 가능성

가능하면 리소스를 클라이언트 또는 서버 측에서 캐싱할 수 있어야 함. 또한 서버 응담에는 전달된 리소스에 대해 캐싱이 허용되는지 여부에 대한 정보도 포함되어야 함.

 

5. 계층 구조 아키텍처

호출과 응답이 서로 다른 계층을 통과함. 클라이언트와 서버 애플리케이션이 서로간 직접 연결된다고 가정하지 않는 것이 좋음. 통신 루프에 다수의 서로 다른 중개자가 있을 수 있고, 알 수 없도록 설계되어야 함.

 

6. 코드 온디맨드(옵션)

일반적으로 정적 리소스를 전송하지만, 특정한 경우에는 응답에 실행코드를 포함할 수도 있음. 이 경우 코드는 요청시에만 실행되어야 함.

 

위와 같은 원칙에 맞게 설정된 API를 REST API라고 한다. 그러면 REST API는 어떻게 작동하는 걸까?

 

 

🤔 REST API의 작동 원리

REST API는 HTTP 요청을 통해 통신함으로써 리소스 내에서 레코드(CRUD)의 작성, 읽기, 업데이트 및 삭제 등의 표준 데이터베이스 기능을 수행한다.

 

예를 들어, REST API는 GET 요청을 사용하여 레코드를 검색하고, POST 요청을 사용하여 레코드를 작성하며, PUT 요청을 사용하여 레코드를 업데이트하고, DELETE 요청을 사용하여 레코드를 삭제한다. 모든 HTTP 메소드는 API 호출에서 사용될 수 있다. 잘 디자인된 REST API는 HTTP 기능이 내장된 웹 브라우저에서 실행되는 웹 사이트와 유사하다.

 

특정 순간 또는 타임스탬프의 리소스 상태를 리소스 표현이라고 하는데, 이러한 정보는 JSON(JavaScript Object Notation), HTML, XLT, Python, PHP 또는 일반 텍스트를 포함하여 실제로 거의 모든 형식으로 클라이언트에 전달될 수 있다. JSON은 사람과 기계가 모두 읽을 수 있고 프로그래밍 언어에 구애받지 않기 때문에 자주 사용된다.

 

요청 헤더와 매개변수 역시 메타데이터, 권한 부여, URI(Uniform Resource Identifier), 캐싱, 쿠키 등의 중요한 식별자 정보를 포함하므로 REST API 호출에서 중요하다. 요청 헤더와 응답 헤더는 일반적인 HTTP 상태 코드와 함께 잘 디자인된 REST API 내에서 사용된다.