RESTful API ?

---

 

• ✅ 들어가기 전 REST에 대한 개념을 이해하기 위해서는 아래 HTTP 프로토콜에 대한 사전 지식이 있으면 좋을 것 같아 먼저 읽어보시는 것을 추천드립니다 😀

HTTP 프로토콜과 상태코드

---

1. RESTful 이란 ?

• REST API를 제공하는 웹 서비스를 RESTful 하다라고 정의할 수 있습니다. 즉, REST 원리를 따르는 시스템을 RESTful 하다라고 지칭할 수 있습니다.
• 이해하기 쉽고 사용하기 쉬운 REST API를 만드는 것이 목적이며, RESTful한 API를 구현하는 근본적인 목적은 성능이 아니라 일괄적인 컨벤션을 통해 API의 이해도 및 호환성을 높이는 것을 주요 목적으로 하며, 성능이 중요한 상황에서는 굳이 RESTful API를 구현할 필요는 없습니다.

2. 그렇다면 REST, REST API 란 무엇일까요?

   2-1. REST 란?

 

• ✅ 다양한 클라이언트가 등장하고, 어플리케이션의 분리 및 통합이 많아지면서 이러한 멀티 플랫폼에 대한 지원을 위해 서비스 자원에 대한 아키텍처를 세우고 이용하는 방법을 모색한 결과 REST가 관심받기 시작했습니다.

REST - 정의

---

• "Representation State Transfer"의 약자, 자원을 이름으로 구분하여 자원의 상태를 주고받는 모든 것을 의미하며, 네트워크상에서 Client와 Server 사이의 통신 방식 중 하나입니다.
• 월드 와이드 웹과 같은 분산 하이퍼미디어 시스템을 위한 소프트웨어 개발 아키텍처의 한 형식인 REST는 기본적으로 웹의 기존 기술과 HTTP 프로토콜을 그대로 사용하기 때문에 웹의 장점을 최대한 활용 가능한 아키텍처 스타일 입니다.

 

✨ [일반] 자원(resource)의 표현(representation)에 의한 상태 전달을 의미합니다.

• 자원(resource) : 해당 소프트웨어가 관리하는 모든 것 ..ex) 문서, 그림, 해당 소프트웨어 자체 등
• 표현(representation) : 자원을 표현하기 위한 이름 ..ex) DB에서 학생 정보가 자원일 때, 'students'를 자원의 표현으로 정합니다
• 상태 전달 : 데이터가 요청되어지는 시점에서 자원의 상태(정보)를 전달합니다. 일반적으로 JSON 혹은 XML을 통해 데이터를 주고 받습니다.

✨ [구체적] HTTP URI을 통해 자원을 명시하고, HTTP Method를 통해 해당 자원에 대한 CRUD Operation을 적용하는 것을 의미합니다. 

 

* CRUD Operation이란 컴퓨터가 가지는 데이터 처리 기능인 Create(생성), Read(읽기), Update(갱신), Delete(삭제)를 묶어서 일컫는 말로, REST에서 동작 예시는 아래와 같습니다.

 

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

 

REST - 특징

---

• Sever - Client (서버 - 클라이언트 구조)
  
  
  • 자원이 있는 쪽이 Server(API 제공, 비즈니스 로직 처리 및 저장), 자원을 요청하는 쪽이 Client(사용자 인증 정보 관리)가 됩니다.
  • 서로간의 의존성이 줄어듭니다.
• Stateless (무상태)
  
  
  • HTTP 프로토콜은 Stateless 프로토콜 이므로 REST 또한 무상태성을 가집니다.
  • Client의 사용자 인증 정보를 Server에 저장하지 않아 신경쓰지 않아도 되므로 구현이 단순해집니다.
  • Server는 각각의 요청을 완전히 별개의 것으로 인식하고 처리합니다.
• Cacheable (캐시 처리 기능)
  
  
  • HTTP 프로토콜을 그대로 사용하므로 웹에서 사용하는 기존의 인프라를 그대로 사용 가능합니다.
  • 대량의 요청을 효율적으로 처리하기 위해 캐시가 요구되며, 캐시 사용을 통해 응답시간이 빨라지고 REST Server 트랜잭션이 발생하지 않아 전체 응답시간, 성능, 서버의 자원 이용률을 향상 시 킬 수 있습니다.
• Layered System (계층화)
  
  
  • Client는 REST API Server만 호출합니다.
  • REST Server는 다중 계층으로 구성될 수 있습니다. 또한 API Server는 순수 비즈니스 로직을 수행하고 그 앞단에 보안, 로드밸런싱, 암호화, 사용자 인증 등을 추가하여 구조상 유연성과 확장성, 보안성을 향상시킬 수 있습니다.
  • PROXY, 게이트웨어 같은 네트워크 기반의 중간 매체를 사용 할 수 있습니다.
• Uniform Inerface (인터페이스의 일관성)
  
  
  • URI로 지정한 Resource에 대한 조작을 통일되고 한정적인 인터페이스로 수행합니다.
  • HTTP 표준 프로토콜을 따라는 모든 플랫폼에서 사용이 가능하며, 특정 언어나 기술에 종속되지 않습니다.

 

REST - 장단점

---

• 장점
  
  
  • HTTP 프로톨콜의 인프라를 그래도 사용하므로 REST API 사용을 위한 별도의 인프라 구축이 필요없으며, 그 외 여러 추가적인 장점을 함께 가져갈 수 있습니다.
  • HTTP 프로토콜에 따르는 모든 플랫폼에서 사용이 가능합니다.
  • Hypermedia API의 기본을 충실히 지키면서 범용성을 보장합니다.
  • REST API 메시지가 의도하는 바를 명확하게 나타내므로 이를 쉽게 파악할 수 있습니다.
  • 서버와 클라이언트의 역항르 명확하게 분리합니다.
• 단점
  
  
  • 표준이 존재하지 않아 정의가 필요합니다.
  • 사용할 수 있는 메서드가 HTTP Method 4가지로 제한적이다.
  • 브라우저를 통해 테스트할 일이 많은 서비스라면 쉽게 고칠 수 있는 URL보다 Header 정보의 값을 처리해야하므로 전문성이 요구됩니다.
  • 구형 브라우저(익스플로어)와 호환이 좋지 못합니다.

 

   2-2. REST API 란?

 

REST API - 정의

---

• REST 기반으로 서비스 API를 구현하는 것 입니다.
• 최근 Open API, 마이크로 서비스 등을 제공하는 업체 대부분은 REST API를 제공합니다.

 

REST API - 특징

---

• REST 기반으로 시스템을 분산해 확장성과 재사용성을 높여 유지보수 및 운용을 편리하게 할 수 있습니다.
• HTTP 표준을 기반으로 구현하므로, HTTP를 지원하는 프로그램 언어로 Client, Server를 구현 할 수 있습니다.
• REST API를 올바르게 설계하기 위해 지켜야하는 규칙들이 있습니다.

 

REST API - 설계 기본 규칙

---

• URL은 동사보다는 명사를, 대명사보다는 소문자를 사용합니다.
  
  
  • Bad Ex : http://ji-musclecode.com/Running/
    Good Ex : http://ji-musclecode.com/run/
• 마지막에 슬래시(/)를 포함하지 않습니다. 
  
  
  • Bad Ex : http://ji-musclecode.com/test/
    Good Ex : http://ji-musclecode.com/test
• 언더바 대신 하이폰을 사용합니다.
  
  
  • Bad Ex : http://ji-musclecode.com/test_blog
    Good Ex : http://ji-musclecode.com/test-blog
• 파일확장자는 URL에 포함하지 않습니다.
  
  
  • Bad Ex : http://ji-musclecode.com/photo.jpg
    Good Ex : http://ji-musclecode.com/photo
• 행위를 포함하지 않습니다.
  
  
  • Bad Ex : http://ji-musclecode.com/delete-post/1
    Good Ex : http://ji-musclecode.com/post/1
     

🤔  정리 !

• RESTful 이란 REST API를 제공하는 웹서비스 즉, REST 원리를 따르는 시스템이라고 정의할 수 있다 !
• REST란 HTTP URI을 통해 자원을 명시하고, HTTP Method를 통해 해당 자원에 대한 CRUD Operation을 적용하는 것을 의미 !
• REST API란 REST기반으로 API를 구현하는 것 !

 

 

🔗 참고한 글

[서버] REST API란? - 하나몬