1. Rest API란
- Respresentational Sate Transfer의 약자
- 자원의 이름 (자원의 표현)으로 구분하여 해당 자원의 상태(정보)를 주고 받는 모든 것
- 자원(resource)의 표현(representation)에 의한 상태 전달
- HTTP URI를 통해 자원을 명시하고 HTTP Method(POST, GET, PUT, DELETE)를 통해 해당 자원에 대한 CRUD Operation을 적용하는 것을 의미
2. Rest API를 사용하는 이유
- API도 체계가 필요하다는 관점에서 나온 방법
- API를 다양한 사람들 (프런트 개발자, 기획자, 고객 등)이 사용하는 만큼 규칙과 내용을 ‘간단하고 쉽게' 만듬
- 메서드만 보고 요청의 내용을 알아볼 수 있다.
- REST는 서버의 자원을 정의하고 자원에 대한 주소를 지정하는 방법을 가르킴
3. Rest API 사용법
- URL에는 동사(자원에 대한 행위)를 사용하지 않는다. (get, post 등)
- 컬렉션은 복수로 사용한다 /movies (URI는 정보 자원을 표현해야 한다는 법칙)
- DB의 고유 식별자 사용 /mivies/inception
- 동사는 HTTP Method를 사용한다 (GET, POST, PUT, DELETE ….)
- GET + /movies → 영화들의 목록을 가져옴, POST + /movies → 영화들의 목록에 새로운 영화를 추가
- 필터링 등을 사용할 때에는 Query parameter를 사용하면 좋음
GET + /movies?min_rating=9.8
GET + /movies?release_date=2021
GET + /movies?pages=3