[RESTful]REST, REST API, RESTful이란?

 REST 란?

 REST 정의 

REST란 Representational State Transfer의 약자로 소프트웨어 프로그램 아키텍처의 한 형식입니다.

• REST는 기본적으로 웹의 기존 기술과 HTTP 프로토콜을 그대로 활용하기 때문에 웹의 장점을 최대한 활용할 수 있는 아키텍처 스타일입니다.
• REST는 네트워크 상에서 Client와 Server 사이의 통신 방식 중 하나입니다.

자원을 이름(자원의 표현)으로 구분하여 해당 자원의 상태(정보)를 주고 받는 모든 것을 의미합니다.

즉! 자원(resource)의 표현(representation)에 의한 상태 전달인 것이죠!

1. 자원(resource)의 표현(representation)
▸ 자원: 해당 소프트웨어가 관리하는 모든 것
ex) 문서, 그림, 데이터, 해당 소프트웨어 자체 등
▸자원의 표현: 그 자원을 표현하기 위한 이름
ex) DB의 학생 정보가 자원일 때 'students'를 자원의 표현으로 정한 것

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

---

 REST의 구체적인 개념 

REST란

• HTTP URI을 통해 자원(resource)을 명시하고,
• HTTP Method(POST, GET, PUT, DELETE, PATCH 등)를 통해
• 해당 자원(URI)에 대한 CRUD Operation을 적용하는 것을 의미합니다.

CRUD Operation이란?
CRUD는 대부분의 컴퓨터 소프트웨어가 가지는 기본적인 데이터 처리 기능인 Create, Read, Update, Delete를 묶어서 일컫는 말입니다.

 ৹ Create : 데이터 생성(POST)
 ৹ Read : 데이터 조회(GET)
 ৹ Update : 데이터 수정(PUT, PATCH)
 ৹ Delete : 데이터 삭제(DELETE)

---

 REST의 구성요소

• 자원(resource) : HTTP URI
  • 모든 자원에 고유한 id가 존재하고, 이 자원은 Server에 존재합니다.
  • 자원을 구별하는 id는 ‘/groups/:group_id’과 같은 HTTP URI입니다.
  • Client는 URI를 이용해서 자원을 지정하고 해당 자원의 상태(정보)에 대한 조작을 Server에 요청합니다.
• 자원에 대한 행위(Verb) : HTTP Method
  • HTTP 프로토콜의 Method를 사용합니다.
  • HTTP 프로토콜은 GET, POST, PUT, DELETE와 같은 메서드를 제공합니다.
• 자원에 대한 행위의 내용(Representations) : HTTP Message Pay Load
  • Client가 자원의 상태(정보)에 대한 조작을 요청하면 Server는 이에 적절한 응답(representation)을 보냅니다.
  • REST에서 하나의 자원은 JSON, XML, TEXT, RSS 등 여러 형태의 representation으로 나타낼 수 있습니다.
    (JSON 혹은 XML을 통해 데이터를 주고 받는 것이 일반적입니다!)

---

 REST의 특징

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

• 자원이 있는 쪽이 Server, 자원을 요청하는 쪽이 Client가 됩니다.
  ৹  REST Server: API를 제공하고 비즈니스 로직 처리 및 저장을 책임집니다.
  ৹  Client: 사용자 인증이나 context(세션, 로그인 정보) 등을 직접 관리하고 책임집니다.
• 이 구조로 서로 간 의존성이 줄어들게 됩니다.

2️⃣ Stateless(무상태)

• HTTP 프로토콜은 Stateless Protocol이므로 REST 역시 무상태성을 갖습니다.
• Client의 context를 Server에 저장하지 않습니다.
  ৹ 즉, 세션과 쿠키같은 context 정보를 신경쓰지 않아도 되므로 구현이 단순해집니다.
• Server는 각각의 요청을 완전히 별개의 것으로 인식하고 처리합니다.
  ৹ 각 API 서버는 Client의 요청을 단순 처리합니다.
  ৹ 즉, 이전 요청이 다음 요청의 처리에 연관되어서는 안됩니다.
  ৹ 물론 이전 요청이 DB를 수정하여 DB에 의해 바뀌는 것은 허용합니다.
  ৹  Server의 처리 방식에 일관성을 부여하고 부담이 줄어들며, 서비스의 자유도가 높아집니다. 

3️⃣ Cacheable(캐시 처리 가능)

• 웹 표준 HTTP 프로토콜을 그대로 사용하므로 웹에서 사용하는 기존의 인프라를 그대로 사용할 수 있습니다.
  ৹ 즉, HTTP가 가진 가장 강력한 특징 중 하나인 캐싱 기능을 적용할 수 있습니다!
• 대량의 요청을 효율적으로 처리하기 위해 캐시가 요구될 수 있습니다.
• 캐시 사용을 통해 응답시간이 빨라지고 REST Server 트랜잭션이 발생하지 않기 때문에 전체 응답시간, 성능, 서버의 자원 이용률을 향상시킬 수 있습니다.

4️⃣ Layered System(계층화)

• Client는 REST API Server만 호출합니다.
• REST Server는 다중 계층으로 구성될 수 있습니다.
  ৹ API Server는 순수 비즈니스 로직을 수행하고 그 앞단에 보안, 로드밸러싱, 암호화, 사용자 인증 등을 추가하여 구조상의 유연성을 줄 수 있습니다.
  ৹ 또한 로드밸런싱, 공유 캐시 등을 통해 확장성과 보안성을 향상시킬 수 있습니다.
• PROXY, 게이트웨이 같은 네트워크 기반의 중간 매체를 사용할 수 있습니다.

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

• URI로 지정한 resource에 대한 조작을 통일하고 한정적인 인터페이스로 수행합니다.
• HTTP 표준 프로토콜에 따르는 모든 플랫폼에서 사용이 가능합니다.
  ৹ 특정 언어나 기술에 종속되지 않습니다.

---

 REST API 란? 

 API란 

Application Programming Interface의 약자로

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

 

 REST API 정의 

REST를 기반으로 서비스 API를 구현 한 것이 REST API입니다.

OpenAPI(누구나 사용할 수 있도록 공개된 API: 구글 맵, 공공 데이터 등), 마이크로 서비스(하나의 큰 애플리케이션을 여러 개의 작은 애필리케이션으로 쪼개어 변경과 조합이 가능하도록 만든 아키텍처) 등을 제공하는 업체 대부분은 REST API를 제공하고 있습니다.

 

---

 REST API 특징 

1️⃣ 사내 시스템들도 REST 기반으로 시스템을 분산해 확장성과 재사용성을 높여 유지보수 및 운용을 편리하게 할 수 있습니다.

2️⃣ REST는 HTTP 표준을 기반으로 구현하므로, HTTP를 지원하는 프로그램 언어로 클라이언트, 서버를 구현할 수 있습니다.

즉, REST API를 제작하면 델파이 클라이언트 뿐 아니라 자바, C#, 웹 등을 이용해 클라이언트를 제작할 수 있습니다.

 

---

 REST API 설계 규칙 

1. URI는 동사보다는 명사를, 대문자보다는 소문자를 사용해야 합니다.

Bad Example 
http://haegomm.com/Running/
Good Example  
http://haegomm.com/run/  

 

2. 마지막에 슬래시(/)를 포함하지 않습니다.

Bad Example 
http://haegomm.com/test/
Good Example  
http://haegomm.com/test

 

3. 언더바 대신 하이폰을 사용합니다.

Bad Example
http://haegomm.com/test_blog
Good Example 
http://haegomm.com/test-blog

 

4. 파일확장자는 URI에 포함하지 않습니다.

Bad Example
http://haegomm.com/photo.jpg
Good Example 
http://haegomm.com/photo

 

5. 행위를 포함하지 않습니다.

Bad Example
http://haegomm.com/delete-post/1
Good Example 
http://haegomm.com/post/1

---

 RESTful 이란? 

 RESTful 정의 

RESTful은 일반적으로 REST라는 아키텍처를 구현하는 웹 서비스를 나타내기 위해 사용되는 용어입니다.

그래서 'REST API'를 제공하는 웹 서비스를 'RESTful'하다라고 할 수 있는 것이죠!

RESTful은 REST를 REST답게 쓰기 위한 방법으로, 누군가 공식적으로 발표한 것은 아닙니다. 따라서 REST원리를 따르는 시스템이라면 RESTful이란 용어로 지칭하고 있습니다.

 

---

 RESTful 목적 

• 이해하기 쉽고 사용하기 쉬운 REST API를 만듭니다.
• RESTful한 API를 구현하는 근본적인 목적은 성능 향상이 아니라 일관적인 컨벤션을 통한 API의 이해도와 호환성을 높이는 것입니다.

 

---

참고자료

 

https://hahahoho5915.tistory.com/54

[간단정리] REST, REST API, RESTful 특징

https://khj93.tistory.com/entry/%EB%84%A4%ED%8A%B8%EC%9B%8C%ED%81%AC-REST-API%EB%9E%80-REST-RESTful%EC%9D%B4%EB%9E%80#google_vignette

[네트워크] REST API란? REST, RESTful이란?

https://velog.io/@somday/RESTful-API-%EC%9D%B4%EB%9E%80

RESTful API 이란