[Web] RESTful API란?

 

REST 

- Representational State Transfer

- API 작동 방식에 대한 조건을 부과하는 소프트웨어 아키텍처이다.

- 복잡한 네트워크에서 통신을 관리하기 위해 만들어졌다.

- REST 기반 아키텍처를 사용하여 대규모의 고성능 통신을 안정적으로 지원할 수 있다.

 

RESTful API

✔️개념

- 두 컴퓨터 시스템이 인터넷을 통해 정보를 안전하게 교환하기 위해 사용하는 인터페이스이다.

- 안전하고 신뢰할 수 있으며 효율적인 소프트웨어 통신 표준을 따른다.

 

✔️작동방식

- 인터넷 브라우징과 동일함

 

1. client가 server에 요청을 전송한다. API 문서에 따라 server가 이해하는 방식으로 요청 형식을 지정

2. server가 client를 인증하고 해당 요청을 수행할 수 있는 권한이 client에 있는지 확인한다.

3. server가 요청을 수신하고 내부적으로 처리한다.

4. server가 client에 응답을 반환한다. (응답에는 요청 성공 여부를 알려주는 정보, client가 요청한 모든 정보 포함됨) 

 

✔️client 요청 구성요소

고유 리소스 식별자

   server는 고유한 리소스 식별자로 각 리소스를 식별함. REST 서비스의 경우 일반적으로 URL을 사용하여 식별함.

   URL은 요청 엔드포인트라고도 하며 client가 요구하는 사항을 server에 명확하게 지정함.

 

메서드 

   HTTP 메서드는 리소스에 수행해야 하는 작업을 server에 알려줌

   ⬇️ 일반적인 4가지의 HTTP 메서드

    GET : client는 GET을 사용하여 server의 지정된 URL에 있는 리소스에 액세스함. GET 요청을 캐싱하고 RESTful API 요청에 파라미터를 넣어 전송하여 전송전에 데이터를 필터링하도록 server에 지시할 수 있다.

 

    POST : client는 POST를 사용하여 server에 데이터를 전송한다. 데이터 표현이 포함됨.

    PUT : client는 PUT을 사용하여 server의 기존 리소스를 업데이트한다. POST와 달리 RESTful 웹 서비스에서 동일한 PUT 요청을 여    러번 전송해도 결과는 동일하다.

    DELETE : client는 DELETE 요청을 사용하여 리소스를 제거한다. DELETE 요청은 server상태를 변경할 수 있다. 

 

HTTP 헤더

    요청 헤더는 client - server 간에 교환되는 메타데이터. 요청 및 응답의 형식을 나타내고 요청 상태 등에 대한 정보를 제공한다.

    

    데이터 : REST API 요청에는 POST, PUT 및 기타 HTTP 메서드가 성공적으로 작동하기 위한 데이터가 포함된다.

    파라미터 : 수행해야 할 작업에 대한 자세한 정보를 server에 제공한다.

          - 경로 파라미터 : URL 세부정보를 지정

          - 쿼리 파라미터 : 리소스에 대한 추가 정보를 요청

          - 쿠키 파라미터 : client를 빠르게 인증

 

✔️장점

1. 확장성

REST API를 구현하는 시스템은 효율적으로 크기를 조정할 수 있다.

무상태는 server 가 과거 client 요청 정보를 유지할 필요가 없기 때문에 server로드를 제거한다.

성능을 저하시키는 통신 병목 현상을 일으키지 않으면서 확장성을 지원한다.

 

2. 유연성

RESTful 웹 서비스는 완전한 client-server 분리를 지원한다.

각 부분이 독립적으로 발전할 수 있도록 다양한 server 구성 요소를 단순화하고 분리한다.

기술 변경을 한다해도 client 애플리케이션에 영향을 주지 않기 때문에 개발자는 애플리케이션 로직을 다시 작성하지 않고도 데이터베이스 계층을 변경할 수 있다.

 

3. 독립성

REST API는 사용되는 기술과 독립적이다.

API 설계에 영향을 주지 않고 다양한 프로그래밍 언어로 client 및 server 애플리케이션을 모두 작성할 수 있다.

또한 통신에 영향을 주지 않고 양쪽의 기본 기술을 변경할 수 있다.

 

 

✳️ 참조 

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