Rest API 란

REST API 정의

REST API라는 단어에서 사용되는

REST( REpresentational State Transfer 의 약자로 소프트웨어 프로그램 아키텍처의 한 형식입니다.)

한국말로 풀어보자면 자원을 이름(자원의 표현)으로 구분하여 해당 자원의 상태(정보)를 주고 받는 모든 것

개념을 한 줄로 정의하자면 아래와 같이 정의할 수 있습니다.

HTTP 통신에서 어떤 자원에 대한 CRUD 요청을 Resource와 Method로 표현하여 특정한 형태로 전달하는 방식

REST API의 등장은 2000년도의 HTTP의 주요 저자 중 한 사람인 로이 필딩이 그 당시 웹 설계의 우수성에 비해 제대로 사용되지 못하는 모습에 안타까워하며 웹의 장점을 최대한 활용할 수 있는 아키텍처(Architecture : 시스템 목적을 달성하기 위해 시스템의 상호작용 등의 시스템 디자인에 대한 제약 및 설계)로써 REST를 발표함.

REST 구성

REST API는 다음의 구성으로 이루어져있습니다.

1) 자원 (Resource) - URL

• 모든 자원에는 고유한 ID가 존재하게 되고, 이 자원은 Server에 존재한다.
• 자원을 구별하는 ID는 HTTP URL로 구분하게 된다. (ex) /members/1
• Client는 URL을 이용하여 자원을 지정하고 해당 자원에 대한 조작을 Server에 요청한다

2) 행위 (Verb) - Http method

• Client는 HTTP Method(POST, GET, DELETE, PUT)를 이용하여 지정한 자원에 대한 조작을 요청한다.

3) 표현 (Representations)

• Client가 Server에 자원에 대한 조작을 요청하면 Server는 이에 대한 적절한 응답(Representation)을 보낸다.

REST 특징

REST 아키택처를 이용하여 API를 설계하였을 때 아래와 같은 이점을 가집니다.

1) 클라이언트 / 서버 구조

클라이언트는 유저와 관련된 처리, 서버는 REST Api를 제공함으로써 각각의 역할이 확실하게 구분되고 일관적인 인터페이스로 분리되어 작동할 수 있게 한다.

2) 무상태성 (Stateless)

REST는 HTTP의 특성을 이용하기 때문에 무상태성을 갖는다. 즉 서버에서 어떤 작업을 하기 위해 상태 정보를 기억할 필요가 없고 들어온 요청에 대해 처리만 해주면 되기 때문에 구현이 쉽고 단순해진다.

3) 캐시 처리 가능(Cacheable)

HTTP라는 기존 웹 표준을 사용하는 REST의 특징 덕분에 기본 웹에서 사용하는 인프라를 그대로 사용 가능하다.

 

4) 자체 표현 구조(Self-descriptiveness)

Json을 이용한 메시지 포맷을 이용하여 직관적으로 이해할 수 있고 REST api 메시지만으로 그 요청이 어떤 행위를 하는지 알 수 있다. ( 예를 들면 tistory/seungwon/life/food/pizza이것만 보고도 pizza가 food 이며 life에 속한 것을 단번에 알 수 있다.)

5) 계층화(Layered System)

REST 서버는 다중 계층으로 구성될 수 있으며, 보안, 로드 밸런싱, 암호화 계층 등을 추가해 구조상의 유연성을 둘 수 있고, PROXY, 게이트웨이와 같은 네트워크 기반의 중간매체를 사용할 수 있다.

6) 유니폼 인터페이스(Uniform)

Uniform Interface는 Http 표준에만 따른다면 모든 플랫폼에서 사용이 가능하며, URI로 지정한 리소스에 대한 조작을 가능하게 하는 아키텍처 스타일을 말한다.

 

REST API 디자인 가이드

REST API 설계 시 가장 중요한 항목은 두 가지이다.
1. URL은 정보의 자원을 표현해야 한다.
2. 자원에 대한 행위는 HTTP Method(GET, POST, PUT, DELETE)로 표현한다.

 

출처 :

doorbw.tistory.com/56

doitnow-man.tistory.com/96

velog.io/@kjh107704/REST-%EC%84%9C%EB%B2%84-REST-API%EB%9E%80