이게 Restful한지요?

Question

Get http://bus.co.kr/bus/departure/{terminal-id}밑으로 내리시기 전에, 이 URL이 뭘 의미한다고 보시나요?처음으로 REST API를 작성하려다 보니, 시간이 많이 걸립니다.제 딴에는 &#34;특정 터미널의 버스 출발목록 조회&#34; 라고 만들었거든요.근데 왠지 Restful하게 느껴지질 않습니다.터미널/버스/{터미널ID} 이렇게 해야 할 것 같기도 하고,Restful하다는 게 이리 어렵네요ㅠㅠ다른 분들은 어떻게 생각하시는지 고견을 여쭙습니다.

잣댐스키 · Accepted Answer

터미널/{터미널ID}/버스 라고 저는 생각 되네요. 맨 처음 저 url 을 보았을 땐 해당 터미널에 대한 정보라고 생각했어요. 터미널을 게시글 버스를 댓글로 생각해보면 /터미널 : 터미널 목록 조회 /터미널/{터미널ID} : 터미널 상세 /터미널/{터미널ID}/버스 : 해당 터미널의 버스목록 조회 저는 이렇게 구성할거 같네요

adduci · Answer

리소스 기준으로 bus, departure, terminal 모두 별개의 리소스라면/terminal/{터미널ID}/bus/departure 전 이렇게 할 것 같네요

thlthl · Answer

/terminal/{terminal_id} 로 시작하는 게 특정 터미널을 나타내는 데 더 적합할 거 같고 이 url에 각 터미널마다 버스 목록을 조회하는 게 가독성 측면에서도 좋아보입니다

dev강 · Answer

지역별로 서울이면 02 그안에서 1번 2번설정해주는것도../터미널/지역/터미널ID 이런식으로? 버스도 요즘은 다 번호가있으니..

rodi on July 12th · Answer

Restful 만큼 전세계적으로 특히 국내에서 멋대로 해석되는 경우가 많습니다.사실 로이필딩은 현업의 rest(ful)을 굉장히 싫어했죠.microsoft restful guideline이나google restful guideline을 한번 보시면 도움이 되실거 같습니다.그 외에 국내 정보는 거르는게 좋습니다. (naver d2는 예외.)너무 강박가질 필요는 없을거 같습니다. verb를 맞게 써야한다니, collections과 명사를 어떻게 써야한다느니.. 의미없다고 생각합니다.

ozson · Answer

답변 감사드립니다.명쾌한 답변이였습니다.좀 개념이 서네요^^

카카오콘 · Answer

일단 개발자는 어떤 변수가 들어갈 자리에 항상 변수명을 보다 보니까 문제없어 보일 수 있습니다.그 자리에 숫자나 아무거나 입력한 상태의 URL 을 봤을 때 그 의도가 파악이 되는가? 로 접근해보시면 조금 더 수월하실 듯 합니다.

이게 Restful한지요?

7개의 답변

Q&A 목록