[CS] Rest API

1. REST(Representational State Transfer) 란

• 자원을 이름으로 구분하여 해당 자원의 상태를 주고 받는 모든 것을 의미
• 즉 REST란
  1. HTTP URI를 통해 자원을 명시하고
  2. HTTP Method(POST, GET, PUT, DELETE, PATCH 등)를 통해
  3. 해당 자원에 대한 CRUD Operation을 적용하는 것을 의미

2. REST 구성 요소

• 자원(Resource) : HTTP URI
• 자원에 대한 행위(Verb) : HTTP Method
• 자원에 대한 행위의 내용(Representation) : HTTP Message Pay Load

3. REST의 특징

• Server-Client : 서버-클라이언트 구조
• Stateless : 무상태
• Cacheable : 캐시 처리 가능
• Layered System : 계층화
• Uniform Interface : 인터페이스 일관성

4. REST의 장단점

• 장점
  • HTTP 프로토콜의 인프라를 그래도 사용하므로 REST API 사용을 위한 별도의 인프라 구축 불필요
  • HTTP 프로토콜 표준을 최대한 활용하여 여러 추가적인 장점을 함께 가져갈 수 있다
  • HTTP 표준 프로토콜에 따르는 모든 플랫폼에 사용 가능
  • Hypermedia API의 기본을 충실히 지키면서 범용성을 보장
  • REST API 메시지가 의도하는 바를 명확하게 나타내므로 의도하는 바를 쉽게 파악 할 수 있다.
  • 여러 가지 서비스 디자인에서 생길 수 있는 문제를 최소화 한다.
  • 서버와 클라이언트의 역할을 명확하게 분리한다.
• 단점
  • 표준이 자체가 존재하지 않아 정의가 필요
  • HTTP Method 형태가 제한적
  • 브라우저를 통해 테스트할 일이 많은 서비스라면 쉽게 고칠 수 있는 URL보다 Header 정보의 값을 처리해야하므로 전문겅이 요구 된다.
  • 구형 브라우저에는 호환이 되지 않아 지원해주지 못하는 동작이 많다.

5. REST API 란

• REST의 원리를 따르는 API 이며 몇가지 규칙이 있다.
• URI는 동사보다 명사를, 대문자보다 소문자를 사용해야한다.
  • Bad Example http://khj93.com/Running/ 
    
  • Good Example  http://khj93.com/run/ 
• 마지막에 슬래시(/)를 포함하지 않는다.
• 언더바 대신 하이폰을 사용한다.
• 파일확장자는 URI에 포함하지 않는다.
• 행위를 포함하지 않는다.
  • Bad Example http://khj93.com/delete-post/1  
    
  • Good Example  http://khj93.com/post/1  

6. RESTful 이란

• REST의 원리를 따르는 시스템을 의미한다.
• REST를 사용했다고 모두가 RESTful한 것은 아니다.
• REST API의 설계 규칙을 올바르게 지킨 시스템을 RESTful하다 말할 수 있다.
  • 모든 CRUD기능을 POST로 처리하는 것은 RESTful하지 못하다고 할 수 있다.

 

2. 출처

1)REST API : 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

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