RESTful API

RESTful API는 무엇일까 ?

RESTful API는 REST 특징을 지키면서 API를 제공한다는 의미입니다.
어렵다면 "프론트엔드에서 백엔드 API를 호출할 url을 어떻게 만들것인가?"에 대한 이야기라고 생각하셔도 됩니다.

그렇다면 REST는 뭐지 ?

REST(REpresentational State Transfer)란 웹에 존재하는 모든 자원(resource, ex. 이미지, 동영상, 데이터)에 고유한 URI를 부여하여 자원에 대한 주소를 지정하는 방법론, 또는 규칙입니다. 현재 가장 널리 사용되고 있습니다.

REST 규칙 예시

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