REST, REST API, RESTful 정리
● REST
REST(Representational State Transfer)의 약자로
자원을 이름으로 구분하여 해당 자원의 상태를 주고 받는 것을 의미한다.
- REST란?
- HTTP URI(Uniform Resource Identifier)를 통해 자원 (Resource)을 명시하고
- HTTP Method(POST, GET, DELETEm PATCH 등)을 통해
- 해당 자원(URI)에 대한 CRUD Operation 적용을 의미한다.
CRUD Operation
CRUD는 대부분 컴퓨터 소프트웨어가 가지는 기본적인 데이터 처리기능인
Create(생성), Read(읽기), Update(갱신), Delete(삭제)를 묶어서 일컫는 말로
REST에서의 CRYD Operation 동작은 아래와 같다.
# Create : 데이터 생성(POST)
# READ : 데이터 조회(GET)
# Update : 데이터 수정(PUT, PATCH)
# Delete : 데이터 삭제(DELETE)
- REST 구성요소
- 자원(Resource) : HTTP URI
- 자원에 대한 행위(Verb) : HTTP Method
- 자원에 대한 행위의 내용(Representations) : HTTP Message Pay Load
- REST의 특징
- Server-Client(서버 - 클라이언트 구조)
- Stateless(무상태)
- Cacheable(캐시 처리 기능)
- Layered System(계층화)
- Uniform Interface(인터페이스 일관성)
- REST의 장단점
장점
# HTTP 프로토콜의 인프라를 그대로 사용하므로 REST API 사용을 위한 별도의 인프라 구축이 필요없다.
# HTTP 프로토콜의 표준을 최대한 활용하여 여러 추가적인 장점을 함께 가져갈 수 있다.
# HTTP 표준 프로토콜에 따르는 모든 플랫폼에서 사용할 수 있다.
# Hypermedia API의 기본을 충실히 지키면서 범용성을 보장한다.
# REST API 메시지가 의도하는 바를 명확하게 나타내므로 의도하는 바를 쉽게 파악할 수 있다.
# 여러가지 서비스 디자인에서 생길 수 있는 문제를 최소화한다.
# 서버와 클라이언트의 역할을 명확하게 분리한다.
단점
# 표준규약이 존재하지 않아 정의가 필요하다.
# HTTP Method 형태가 제한적이다.
# 브라우저를 통해 테스트하 일이 많은 서비스라면 쉽게 고칠 수 있는 URL보다
Header 정보의 값을 처리해야 하므로 전문성이 요구된다.
# 구형 브라우저에서 호환이 되지 않아 지원해주지 못하는 동작이 많다.
예) 익스플로어
● REST API
REST를 기반으로 만들어진 API를 의미한다.
REST API를 올바르게 설계하기 위해 지켜야하는 몇가지 규칙이 있다.
※ REST API 설계 예시
URI는 동사보다는 명사를, 대문자보다는 소문자를 사용해한다.
Bad Example http://khj93.com/Running/
Good Example http://khj93.com/run/
마지막에 슬래시 (/)를 포함하지 않는다.
Bad Example http://khj93.com/test/
Good Example http://khj93.com/test
언더바 대신 하이폰을 사용한다.
Bad Example http://khj93.com/test_blog
Good Example http://khj93.com/test-blog
파일확장자는 URI에 포함하지 않는다.
Bad Example http://khj93.com/photo.jpg
Good Example http://khj93.com/photo
행위를 포함하지 않는다.
Bad Example http://khj93.com/delete-post/1
Good Example http://khj93.com/post/1
● RESTful
RESTFUL이란 REST의 원리를 따르는 시스템을 의미한다.
하지만 REST를 사용했다고 하여 모두가 RESTFUL한 것은 아니다.
REST API의 설계 규칙을 올바르게 지킨 시스템을 RESTful하다 말할 수 있으며,
모든 CRUD 기능을 POST로 처리하는 API와 URI 규칙을 올바르게 지키지 않은 API는
REST API를 사용하였지만 규칙을 올바르게 지키지 못한 시스템으로 RESTful하지 못한 시스템이라 한다.