REST API

REST(REpresentational State Transfer)

---

2020년도 로이 필딩의 박사학위 논문에서 최초로 소개된 REST는 당시 웹 설계의 우수성에 비해 제대로 사용되지 못하는 모습에 안타까워하며 웹의 장점을 최대한 활용할 수 있는 아키텍처로써 발표됐다.

쉽게 말하면 REST는 HTTP 기반으로 필요한 자원에 접근하는 방식을 정해놓은 아키텍처다.

 

REST 구성요소

---

REST는 자원(resource), 행위(verb), 표현(representation) 3가지로 구성되어있다.

- 자원: URI, 모든 자원에 고유한 ID가 존재하고 이 자원은 서버에 존재한다. 자원을 구별하는 id는 URI다.

- 행위: http 프로토콜의 method(*GET, POST, PUT, DELETE)를 사용한다.

- 표현: 클라이언트가 자원의 상태에 대한 조작을 요청 시 서버는 적절한 응답을 보낸다.

 

* HTTP METHOD

POST	URI를 요청하면 리소스 생성
GET	리소스를 조회 및 정보 반환
PUT	리소스 수정
DELETE	리소스 삭제

 

REST 특징

---

1. 서버 클라이언트 구조

2. Stateless(무상태): 클라이언트의 context를 서버에 저장하지 않고, 서버는 각각의 요청을 별개의 것으로 인식하고 처리

3. Cacheable(캐시 처리 가능): 캐시 사용을 통해 응답시간이 빨라지고 REST 서버 트랜잭션이 발생하지 않기 때문에 전체 응답시간, 성능, 서버의 자원 이용률 향상 가능

4. Layered System(계층화): REST 서버는 다중 계층으로 구성될 수 있으며 보안, 로드 밸런싱, 암호화 계층을 추가해 구조상의 유연성을 둘 수 있고 네트워크 기반의 중간매체 사용을 가능하도록 만듦.

5. Uniform Interface(인터페이스 일관성)

 

REST API

---

REST API는 REST를 통해 서비스 API를 구현한 것이다.

REST API를 설계할 땐 1. URI 정보는 자원을 표현, 2. 자원에 대한 행위는 HTTP Method(GET, PUT, POST, DELETE 등)로 표현 2가지는 꼭 기억해야한다.

 

URI 설계

1. 슬래시(/) 구분자는 계층 관계를 나타내기 위해 사용한다.

2. URI 마지막 문자로 슬래시(/)를 포함하지 않는다.

3. 긴 URI를 사용할 경우 하이픈(-)을 사용해 가독성을 높이며, 밑줄(_)은 URI에 사용하지 않는다.

4. URI 경로에는 소문자를 사용하며, 파일확장자는 포함하지 않는다.

 

+) RESTful

일반적으로 REST 아키텍처를 구현하는 웹 서비스를 표현하기 위해 사용되는 용어다.

따라서 REST API를 제공하는 웹 서비스를 RESTful하다고 표현할 수 있다.

 

 

참고 자료

---

gmlwjd9405.github.io/2018/09/21/rest-and-restful.html

medium.com/@dydrlaks/rest-api-3e424716bab

meetup.toast.com/posts/92