Restful API란?

Restful API에 대해서 알려면 우선 REST에 대해서 알아야한다. REST의 개념부터 REST API, Restful API에 대해서 하나씩 알아보자.

REST란?

"Representational State Trasfer" 의 약자로, 자원을 이름(자원의 표현)으로 구분해 해당 자원의 상태(정보)를 주고 받는 모든 것을 의미한다.
-> 자원(resource)의 표현(representation)에 의한 상태 전달

구체적으로, REST의 개념에 대해서...

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

REST의 장단점

• 장점
  - HTTP 프로토콜의 인프라를 그대로 사용하므로 REST API 사용을 위한 별도의 인프라를 구출할 필요가 없다.
  - HTTP 프로토콜의 표준을 최대한 활용하여 여러 추가적인 장점을 함께 가져갈 수 있게 해준다.
  - HTTP 표준 프로토콜에 따르는 모든 플랫폼에서 사용이 가능하다.
  - Hypermedia API의 기본을 충실히 지키면서 범용성을 보장한다.
  - REST API 메시지가 의도하는 바를 명확하게 나타내므로 의도하는 바를 쉽게 파악할 수 있다.
  - 여러가지 서비스 디자인에서 생길 수 있는 문제를 최소화한다.
  - 서버와 클라이언트의 역할을 명확하게 분리한다.
• 단점
  - 표준이 존재하지 않는다.
  • 사용할 수 있는 메소드가 4가지 밖에 없다.(HTTP Method 형태가 제한적이다.)
  • 브라우저를 통해 테스트할 일이 많은 서비스라면, 쉽게 고칠 수 있는 URL보다 헤더 값이 더 어렵게 느껴진다.
  • 구형 브라우저가 아직 제대로 지원해주지 못하는 부분이 존재한다.(PUT, DELETE)

REST API란?

위의 서술한 REST 기반으로 서비스 API를 구현하는 것이다.

REST API 설계 예시

RESTful이란?

일반적으로 REST라는 아키텍쳐를 구현하는 웹 서비스를 나타내기 위해 사용되는 용어이다.
즉, REST API를 제공하는 웹 서비스를 RESTful하다고 할 수 있다.
REST원리를 따르는 시스템은 RESTful 이라는 용어로 지칭되기도 한다.

RESTful의 목적

• 이해하기 쉽고 사용하기 쉬운 REST API를 만드는것
• 성능 향상이 아닌 일관적인 컨벤션을 통한 API의 이해도 및 호환성을 높이는 것이 근본적인 목적이므로, 성능이 중요한 상황에서는 굳이 RESTful API를 구현할 필요는 없다.

RESTful하지 못한 경우

• CRUD 기능을 모두 POST로만 처리하는 API
• route에 resource, id 외의 정보가 들어가는 경우

참조 사이트

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