REST API란?

REST 란?

 

REST 구성 3가지 : 자원, 행위, 메시지

 

1. 자원(resource) : 접근할 대상

 

2. 메서드 : HTTP Method - GET(조회) , POST(생성) , PUT(수정), DELELTE(삭제)
* 일반적으로는 GET, POST 방식을 사용하나, REST에서는 PUT, DELETE도 사용한다.

 

3. 메시지

ex) " 상품명이  진라면인 상품을 생성한다” 라는 호출이 있을 때,
“상품”은 생성되는 자원 (resource)
“생성한다”라는 행위는 메서드 (post)
"상품명이 진라면인 상품"은 메시지   ({"name":"진라면","price":"1000"})

 

위의 예시를 rest 형태로 표현하면?

 

HTTP POST , http://localhost/products/ {
	"products": {
    		"name":"진라면",
		"price":"1000"
	}
}

 

- “Representational State Transfer”의 약자, 자원을 이름(자원의 표현)으로 구분하여 해당 자원의 상태(정보)를 주고 받는 모든 것을 의미한다.

 

- 즉, 자원(resource)의 표현(representation)에 의한 상태 전달

 

A. 자원(resource)의 표현(representation)이란? 

 

자원: 해당 sw가 관리하는 모든 것 ( 문서, 그림, 데이터, 해당 소프트웨어 자체 등) 

자원의 표현: 그 자원을 표현하기 위한 이름 

 

B. 상태(정보) 전달

 

- 데이터가 요청되어지는 시점에서 자원의 상태(정보)를 전달한다. JSON 혹은 XML를 통해 데이터를 주고 받는 것이 일반적이다.

 

- 월드 와이드 웹 (WWW)과 같은 분산 하이퍼미디어 시스템을 위한 소프트웨어 개발 아키텍처의 한 형식REST는 기본적으로 웹의 기존 기술과 HTTP 프로토콜을 그대로 활용하기 때문에 웹의 장점을 최대한 활용할 수 있는 아키텍처 스타일이다.

 

- REST는 네트워크상에서 Client와 Server 사이의 통신 방식 중 하나이다.

 

 

REST 의 구체적인 개념

 

- HTTP(HyperText Transfer Protocol) 는 웹상에서 데이터를 주고 받기 위한 프로토콜을 의미한다.

 

- HTTP URL(Uniform Resource Identifier)을 통해 자원(Resource)을 명시하고, HTTP Method(POST, GET, PUT, DELETE)를 통해 해당 자원에 대한 CRUD Operation을 적용하는 것을 의미한다.

 

- 즉, REST는 자원 기반의 구조(ROA, Resource Oriented Architecture) 설계의 중심에 Resource가 있고 HTTP Method를 통해 Resource를 처리하도록 설계된 아키텍처를 의미한다.

- 웹 사이트의 이미지, 텍스트, DB 내용 등의 모든 자원에 고유한 ID인 HTTP URL를 부여한다.

 

- Create : 생성(POST)
- Read : 조회(GET)
- UPdate : 수정(PUT)
- Delete : 삭제(DELETE)
- HEAD : header 정보 조회(HEAD)

 

 

REST 의 필요성

 

- ‘애플리케이션 분리 및 통합’

- ‘다양한 클라이언트의 등장’

- 최근의 서버 프로그램은 다양한 브라우저와 안드로이드폰, 아이폰과 같은 모바일 디바이스에서도 통신을 할 수 있어야한다.

- 이러한 멀티 플랫폼에 대한 지원을 위해 서비스 자원에 대한 아키텍처를 세우고 이용하는 방법을 모색한 결과, REST에 관심을 가지게 되었다.

 

REST 구성 요소

 

자원(Resource): URL

 

- 모든 자원에 고유한 id가 존재하고, 이 자원은 server에 존재한다.

 

- 자원을 구별하는 id 는 '/groups/:group_id'와 같은 http url이다.

 

- client 는 url를 이용해서 자원을 지정하고 해당 자원의 상태(정보)에 대한 조작을 server에 요청한다.

 

행위 (Verb) : http method

 

- http프로토콜의 Method를 사용한다.

 

- http프로토콜은 get, post, put, delete와 같은 메서드를 제공한다.

 

표현(Representation of Resource): 페이로드를 이

 

- client가 자원의 상태(정보)에 대한 조작을 요청하면 Server는 이에 적절한 응답(Representation)을 보낸다.

 

- Rest에서 하나의 자원은 json, xml, rss, text 등 여러 형태의  Representation으로 나타내어 질 수 있다.

 

- json혹은 xml를 통해 데이터를 주고 받는 것이 일반적이다.

 

 

REST 특징

 

 

Server-Client (서버- 클라이언트 구조)

 

클라이언트(Client) = 고객

서버(Server) : 서비스 제공자

 

 

- 자원이 있는 쪽이 server, 자원을 요청하는 쪽이 Client가 된다.

 

REST Server: api를 제공하고, 비즈니스 로직 처리 및 저장을 책임진다.

client: 사용자 인증이나 context(세션, 로그인 정보) 등을 직접 관리하고 책임진다.

 

- 서로간 의존성이 줄어든다.

 

Stateless (무상태)

 

- http프로토콜은 Stateless Protocol이므로 rest 역시 무상태성을 갖는다.

 

- client의 context를 Server에 저장하지 않는다. ( 즉, 세션과 쿠키와 같은 context정보를 신경쓰지 않아도 되므로 구현이 단순해진다.)

 

- Server는 각각의 요청을 완전히 별개의 것으로 인식하고 처리한다.

 

- 각 api 서버는 client의 요청만을 단순 처리한다.

- 즉, 이전 요청이 다음 요청의 처링 연관되어서는 안된다.

- 물론 이전 요청이 DB를 수정하여 DB에 의해 바뀌는 것은 허용한다.

- server의 처리 방식에 일관성을 부여하고 부담이 줄어들며, 서비스의 자유도가 높아진다.

 

Cacheable(캐시 처리 기능)

 

- 웹 표준 http프로토콜을 그대로 사용하므로 웹에서 사용하는 기존의 인프라를 그대로 활용할 수 있다.

 

- 즉, http가 가진 가장 강력한 특징 중 하나인 캐싱 기능을 적용할 수 있다.

 

- http프로토콜 표준에서 사용하는 Last-Modified태스나 E-Tag를 이용하면 캐싱 구현이 가능하다.

 

- 대량의 요청을 효율적으로 처리하기 위해 캐시가 요구된다.

 

- 캐시 사용을 통해 응답시간이 빨라지고 REST Server트랜잭션이 발생하지 않기 때문에 전체 응답시간, 성능, 서버의 자원 이용률을 향상시킬 수 있다.

 

Layered System(계층화)

- Client는 REST API server만 호출한다.

 

- REST Server는 다중 계층으로 구성될 수 있다.

- API Server는 순수 비즈니스 로직을 수행하고 그 앞단에 보안, 로드밸런싱, 암호화, 사용자 인증 등을 추가하여 구조상의 유연성을 줄 수 있다.

- 또한 로드밸런싱, 공유 캐시 등을 통해 확장성과 보안성을 향상시킬 수 있다.

 

- PROXY, 게이트웨어 같은 네트워크 기반의 중간 매체를 사용할 수 있다.

 

REST API란?

 API(Application Programming Interface) 란?

 

- api란 클라이언트가 리소스를 요청할 수 있도록 서버 측에서 제공된 인터페이스를 말한다.

 

- REST API: REST 아키텍처를 따르는 API를 의미

 

- REST API호출 : REST 방식을 따르고 있는 서버에 특정한 요청을 전송하는 것을 의미 (여기서 어떤 형식으로 데이터를 주고받을지 명시할 필요가 있는데, 바로 여기서 JSON포맷이 사용된다.)

 

+ ) JSON이란? JavaScript Object Notation, 데이터를 주고 받는게 사용하는 경량의 데이터 형식

 

 

 

- 이러한 api로 데이터와 기능의 집합을 제공하여 컴퓨터 프로그램 간 상호작용을 촉진하며, 서로 정보를 교환가능하도록 한다.

 

- 서버를 개발한다는 것은 api에 대한 마스터 권한이 생기는 것이다.

 

- api와 함께 항상 메뉴얼도 제공되어야 한다. 

 

REST API의 정의

 

- REST 기반으로 서비스 API를 구현하는 것

 

- 최근 OPEN API(누구나 사용할 수 있도록 공개된 API) , 마이크로 서비스(하나의 큰 애플리케이션을 여러 개의 작은 애플리케이션으로 쪼개어 변경과 조합이 가능하도록 만든 아키텍쳐) 등을 제공하는 업체 대부분은 REST API를 제공한다.

 

 

REST API 설계 예시

 

참고: 응답 상태 코드

 

1XX : 전송 프로토콜 수준의 정보 교환
2XX : 클라이언트 요청이 성공적으로 수행됨
3XX : 클라이언트는 요청을 완료하기 위해 추가적인 행동을 취해야 함
4XX : 클라이언트의 잘못된 요청
5XX : 서버쪽 오류로 인한 상태코드