REST란?
-
"Representational State Transfer"의 약자로 HTTP URI(Uniform Resource Identifier)를 통해 resource를 명시하고,
-
HTTP Method (POST, GET, PUT, DELETE, PATCH 등)을 통해
-
해당 자원 (URI)에 대한 CRUD Operation을 적용하는 것을 의미한다.
JSON 혹은 XML를 통해 데이터를 주고 받는 것이 일반적이며 월드 와이드 웹 (WWW)과 같은 분산 하이퍼미디어 시스템을 위한 소프트웨어 개발 아키텍처의 한 형식.
CRUD Operation이란
CRUD는 대부분의 컴퓨터 소프트웨어가 가지는 기본적인 데이터 처리 기능인
- Create (생성)
- Read (읽기)
- Update (갱신)
- Delete (삭제)
를 묶어서 일컫는 말로 Rest에서의 CRUD 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 메시지가 의도하는 바를 명확하게 나타내므로 의도하는 바를 쉽게 파악할 수 있다.
- 여러가지 서비스 디자인에서 생길 수 있는 문제를 최소화한다.
- 서버와 클라이언트의 역할을 명확하게 분리한다.
REST의 단점
- 표준이 존재하지 않아 정의가 필요하다.
- HTTP Method 형태가 제한적이다.
- 브라우저를 통해 테스트할 일이 많은 서비스라면 쉽게 고칠 수 있는 URL보다 Header 정보의 값을 처리해야 하므로 전문성이 요구된다.
- 구형 브라우저에서 호환이 되지 않아 지원해주지 못하는 동작이 많다.(익스폴로어)
REST API란?
REST 기반으로 서비스 API를 구현한 것. 최근 OpenAPI(구글 맵, 공공 데이터 등 누구나 사용 가능), 마이크로 서비스 등을 제공하는 업체 대부분은 REST API를 제공한다.
특징
- 사내 시스템들도 REST 기반으로 시스템을 분산해 확장성과 재사용성을 높여 유지보수 및 운용을 편리하게 할 수 있다.
- REST는 HTTP 표준을 기반으로 구현하므로, HTTP를 지원하는 프로그램 언어로 클라이언트, 서버를 구현할 수 있다.
- 즉, REST API를 제작하면 델파이 클라이언트 뿐 아니라, 자바, C#, 웹 등을 이용해 클라이언트를 제작할 수 있다.
REST API 설계 규칙
- URI는 동사보다는 명사를, 대문자보다는 소문자를 사용하여야 한다.
- 마지막에 슬래시 (/)를 포함하지 않는다.
- 언더바(_) 대신 하이폰(-)을 사용한다.
- 파일확장자는(jpg 등등) URI에 포함하지 않는다.
- 행위를 포함하지 않는다.