REST API란?

REST API란 REST를 기반으로 만들어진 API를 의미한다. REST API를 알기 위해 먼저 REST부터 알아보도록 하자.

 

REST란?

REST(Representational State Transfer)의 약자로 자원을 이름으로 구분하여 해당 자원의 상태를 주고받는 모든 것을 의미한다.

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

CRUD는 대부분의 컴퓨터 소프트웨어가 가지는 기본적인 데이터 처리 기능인 Create(생성), Read(읽기), Update(갱신), Delete(삭제)를 묶어서 일컫는 말로 REST에서의 CRUD Operation 동작 예시는 다음과 같다.

CREATE : 데이터 생성 (POST)
READ : 데이터 조회 (GET)
UPDATE : 데이터 수정 (PUT)
DELETE : 데이터 삭제 (DELETE)

REST 구성 요소

REST는 다음과 같은 3가지로 구성되어 있다.

1. 자원(Resource) : HTTP URI
2. 자원에 대한 행위(Verb) : HTTP Method
3. 자원에 대한 행위의 내용 (Representations) : HTTP Message Pay Load

URI란 특정 리소스를 식별하는 통합 자원 식별자(Uniform Resource Identifier)를 의미한다.웹 기술에서 사용하는 논리적 또는 물리적 리소스를 식별하는 고유한 문자열 시퀀스이다.

비록 URL은 URI의 서브셋이지만 URI와 URL의 가장 큰 차이점은 아래와 같다.

=> URI는 식별하고, URL은 위치를 가리킨다.

REST의 특징

1. Server-Client(서버-클라이언트 구조)
2. Stateless(무상태)
3. Cacheable(캐시 처리 가능)
4. Layered System(계층화)
5. Uniform Interface(인터페이스 일관성)

REST API란?

REST API란 REST의 원리를 따르는 API를 의미한다.

REST API를 올바르게 설계하기 위해서는 아래와 같은 규칙들을 따라야 한다.

REST API 설계 규칙

1. URI는 정보의 자원을 표현해야 합니다. (리소스명은 동사보다는 명사를, 대문자보다는 소문자를 사용합니다.)
2. 자원에 대한 행위는 HTTP METHOD로 표현합니다.
3. 마지막에 슬래시(/)를 포함하지 않는다.
4. 언더바 대신 하이폰을 사용한다. ( _ ⇒X / - ⇒ O)
5. 파일 확장자는 URI에 포함하지 않는다. ( photo.jpg ⇒ photo )

RESTful이란?

RESTful이란 REST의 원리를 따르는 시스템을 의미한다.

하지만 REST를 사용했다 하여 모두가 RESTful 한 것은 아니다.

REST API의 설계 규칙을 올바르게 지킨 시스템을 RESTful 하다고 말할 수 있으며 모든 CRUD 기능을 POST로 처리하는 API 혹은 URI 규칙을 올바르게 지키지 않은 API는 REST API를 사용하였으나 RESTful 하지 못한 시스템이라고 할 수 있다.