리소스와 행위의 분리

*RESTful API에서는 모든 것을 **리소스(Resource)*로 봅니다.

예를 들어 ‘회원 정보’, ‘게시글’, ‘상품’ 등이 모두 리소스가 될 수 있습니다. 그리고 이 리소스에 대한 행위(Action)는 URI에 포함시키지 않고 HTTP 메서드를 사용하여 표현합니다.

즉, URI는 리소스 식별에만 집중하고, 행위의 정의는 HTTP 메서드에 위임하는 것입니다.

리소스와 URI 경로

리소스는 크게 두 종류로 나뉘며, URI 경로를 이들을 명확히 구분하여 가리치는 주소 역할을 합니다.

• 컬렉션 리소스
  • URI Ex) /members, /posts, /products
• 단일 리소스
  • URI Ex) /members/100, /posts/42

쿼리 파라미터: 결과에 대한 부가 조건

• /books?sort=newest → "'경제학' 코너에서 책들을 최신순으로 정렬해서 보여주세요."
• /books?author=김미래 → "'경제학' 코너에서 저자가 '김미래'인 책들만 골라서 보여주세요."

URI 경로는 다루고자 하는 리소스를 고유하게 식별하고, HTTP 메서드는 해당 리소스에 수행할 행위를 정의한다.

여기에 쿼리 파라미터를 사용하면 그 행위가 적용될 대상에 세부 조건을 부여할 수 있습니다.

HTTP Method