[191일차] RESTful API란? 그리고 장점까지

RESTful API란?

REST

RESTful API를 알려면 REST의 정의부터 알아야 한다.
Representational State Transfer 의 약자이다.
URI 로 자원(resource)을 특정하고 해당 자원의 상태를 주고받는 것이다.

위와 같이 url을 통해 자원(sale)을 구분하고, http메소드를 통해 행위를 구분한다.

규칙

REST는 그 기반의 규칙들이 있다.

URI는 자원을 표시

동사보다는 명사를 사용해야 하고,
행위에 대한 표현이 들어가면 안된다.
규모가 큰 서비스를 하다보면 피치 못하게 행위를 Uri로 넣는 경우도 있다고 하더라.
예를 들면 배달의 민족에서 배달 시작이라는 API를 피치못하게 Post메소드를 활용해서,
URI에 행위를 넣었다고 한다.

행위는 HTTP 메소드로 표현한다

행위는 각각 CRUD를 뜻하는 메소드를 활용하여 표현하자.

GET: 조회
POST: 리소스 생성
PUT: 리소스 전체 갱신
PATCH: 리소스 부분 갱신
DELETE: 리소스 삭제

그 외 세부규칙

1. 슬래시(/)는 계층관계를 나타낸다.
2. URI의 마지막엔 슬래시(/)를 포함하지 않는다.
   ex)https://www.naver.com/ (x)
3. 가독성을 높일 때 하이폰(-)을 사용하고 언더바(_)는 사용하지 않는다.
4. URI경로에는 소문자만 사용한다.

결국 RESTful API는 REST규칙들을 지켜서 설계된 API를 뜻 한다.

장점

알아보기가 짱쉽다!
API 명세서를 읽지 않고도 요청을 알아보기 쉽다.
서버의 응답을 분석하기가 수월한 것이다.
API설계 부분에서 알아보기가 쉽다는것만큼 강한 장점이 없다.