[기본 개념] REST(FUL) API

1   REST API

1.1   REST API란?

a. HTTP 통신(frontend-server)에서 사용되는 말
b. Representational State Transfer : 상태를 주고 받는 것
c. Application Programming Interface : 프로그램을 사용하는 법
d. 결론 : HTTP 통신에서 쓰이는 자원을 주고받는 방법

 

너무 어려워서 계속 찾아봤는데 단지 HTTP 통신을 어떻게 할 것인지 규정한 방법인 것 같다.

 

1.2   REST API의 필요성

어떠한 목적을 가지고 요청을 했는지 서버가 손쉽게 파악 및 대응이 가능하고, 다른 개발자의 눈으로 보아도 역시 한눈에 파악가능하기 때문

 

1.3   RESTFUL API란?

-ful이 붙은대로 해석하면 됨. 완전 잘 만든 REST API
(API 명세서까지 완벽히 포함해야만 RESTFUL API라고 하는 것 같기도 함)

 

1.4   REST API의 조건 예시

a. 필터링은 Query Parameter를 사용한다.

- 데이터를 검색하는 방법은 수없이 많고, 그 경우의 수에 대응하는 URL을 만드는 것은 불가능하기 때문에 간단한 필터링은 Query String을 이용함

b. CRUD에 맞춰 HTTP Method를 활용
- C(Create) = POST : 생성 
- R(Read) = GET : 조회
- U(Update) = PATCH(PUT) : 수정
=> 보통 PATCH는 데이터 일부 수정 / PUT은 통으로 수정
- D(Delete) = DELETE : 삭제

c. 하이픈(-)을 사용
- 언더바(_), 공백( ) 대신 가독성을 위해 하이픈을 사용함

d. 엔드포인트는 복수형으로 사용
데이터를 가져올 때 'user'보다 'users'를 사용함. 가져올 데이터의 유저가 한명이진 않을테니..!