Rest(REpresentational State Transfer)

• REST: 웹에 존재하는 모든 자원(resorce, ex. 이미지, 동영상, 데이터)에 고유한 URI를 부여하여 자원에 대한 주소를 지정하는 방법론, 또는 규칙입니다. 현재 가장 널리 사용있다
• RESTful API는 REST 특징을 지키면서 API를 제공한다는 의미다

REST 규칙에 어긋나는 url 예시

• url 은 page 기준이 아닌 resource 기준으로 작성
• 메인 페이지에 표출되어야할 정보가 무엇인지 판별하여 url을 결정
• 한 번에 여러 종류의 정보를 표출해야 한다면, 프론트엔드 개발자와 협의하여 REST에 맞춰 두가지 이상의 endpoint를 동시에 호출
• 동사(find)를 사용하지 않습니다.
• 자원을 추가(add)할 때는 ~/post 으로 충분
• 검색 기능은 자원의 정보를 호출하는 기능이므로 [GET] method를 사용
• 검색 키워드는 body를 통해 전달하지 않고, query string을 활용

Query parameters (GET parameters)

• 웹 페이지의 url 주소에 ? 가 포함되어 있는 데, 이 것은 단순한 문자열이 아니며 특정한 기능을 수행하고 있다. 물음표 뒤에는 늘 key=value 형식의 문자열이 오는데 이를 Query parameter 라고 한다
• Query parameters는 주로 데이터를 조건으로 거르거나(filtering), 특정 방식으로 정렬하거나(sorting), 검색(searching)하고자 하는 경우에 활용된다

Path parameters

• 해당 리소스에 더 자세한 정보를 얻기 위해 접근할 때 사용한다