Server: Rest API

MARCOIN·2022년 5월 26일
0

1. Rest API란

  • Respresentational Sate Transfer의 약자
  • 자원의 이름 (자원의 표현)으로 구분하여 해당 자원의 상태(정보)를 주고 받는 모든 것
  • 자원(resource)의 표현(representation)에 의한 상태 전달
  • HTTP URI를 통해 자원을 명시하고 HTTP Method(POST, GET, PUT, DELETE)를 통해 해당 자원에 대한 CRUD Operation을 적용하는 것을 의미

2. Rest API를 사용하는 이유

  1. API도 체계가 필요하다는 관점에서 나온 방법
  2. API를 다양한 사람들 (프런트 개발자, 기획자, 고객 등)이 사용하는 만큼 규칙과 내용을 ‘간단하고 쉽게' 만듬
  3. 메서드만 보고 요청의 내용을 알아볼 수 있다.
  4. REST는 서버의 자원을 정의하고 자원에 대한 주소를 지정하는 방법을 가르킴

3. Rest API 사용법

  1. URL에는 동사(자원에 대한 행위)를 사용하지 않는다. (get, post 등)
  2. 컬렉션은 복수로 사용한다 /movies (URI는 정보 자원을 표현해야 한다는 법칙)
  3. DB의 고유 식별자 사용 /mivies/inception
  4. 동사는 HTTP Method를 사용한다 (GET, POST, PUT, DELETE ….)
  5. GET + /movies → 영화들의 목록을 가져옴, POST + /movies → 영화들의 목록에 새로운 영화를 추가
  6. 필터링 등을 사용할 때에는 Query parameter를 사용하면 좋음
    GET + /movies?min_rating=9.8
    GET + /movies?release_date=2021
    GET + /movies?pages=3
profile
공부하는 기획자 👀

0개의 댓글