//Rest API란
//REpresentational State Transfer의 약자로 어떤 자원에 대해
//CRUD를 진행할 수 있게 HTTP Method(GET,POST,PUT,DELETE)를 사용해
//요청을 보내는 것. 이 때 , 요청을 위한 자원은 특정한 형태로 표현된다
//간단하게 말하면 URI를 통해 정보의 자원을(only자원만을)표현하고,자원의
//행위는 HTTP Method로 명시한다
//자원(Resource) : URI , 행위(Verb):HTTP Method , 표현(Representations)
//GET/users/3/profile =>user중 3번 아이디를 갖는 사람의 프로필 보여줘
//ex)좋은 예 나쁜 예
//DELETE(삭제)요청
// bad
GET /members/delete/1
// good
DELETE /members/1
//GET(조회)요청
// bad
GET /members/show/1
// good
GET /members/1
//POST요청
// bad
GET /members/insert/2
// good
POST /members/2
//REST 규칙
// http://example.com/posts (O)
// http://example.com/posts/ (X)
// http://example.com/post (X)
// http://example.com/get-posts (X)
// --> URI는 명사를 사용하고 소문자로 작성되어야 한다.
// --> 명사는 복수형을 사용한다.
// --> URI의 마지막에는 /를 포함하지 않는다.
// http://example.com/post-list (O)
// http://example.com/post_list (X)
// --> URI에는 언더바가 아닌 하이픈을 사용한다.
// --> URI에는 파일의 확장자를 표시하지 않는다.
//RestFul하다는 것은 무엇인가요?**
//위의 REST API의 까다로운 조건을 만족시킨 통신 설계 상태를 말합니다.
//그 누가 보더라도 이해하기 쉽고, 사용하기 쉬운 REST API라면 “RestFul하구나!” 라고 할 수 있습니다.
//(4) 다음 상황은 RestFul 하지 못하다고 할 수 있겠어요.
//- CRUD의 기능을 모두 POST method로만 이용하는 경우
//- URI에 행위(method)에 대한 부분이 들어가는 경우(/classes/createPeople)
//Path Variable vs Query Parameter
//REST한 개발을 하다 보면, GET method를 이용하여 데이터를 가져올 때 등의 경우에서 Path Variable과
//Query Parameter에 대한 이야기는 항상 같이 나옵니다. 이번 기회에 한번 정리해볼게요!
//Path Variable
///users/10
//
//이름에서도 유추할 수 있듯, 경로 자체에 변수(10)를 사용한 방법입니다.
//전체 데이터 또는 특정 하나의 데이터를 다룰 때 처럼, 리소스를 식별하기 위해 사용돼요.
//Query Parameter
//> /users?user_id=10
//
//데이터를 정렬하거나 필터링 하는 경우 더 적합합니다.
//예시를 통해 비교해보기
<aside>
❗ /users # Fetch a list of users
/users?occupation=programer # Fetch a list of programer user
/users/123 # Fetch a user who has id 123
</aside>