여러 매개 변수가있는 GET HTTP 요청을 처리하는 REST API의 유효한 URI 템플릿은 무엇일까요?

Question

2 개의 매개 변수가 필요한 GET 요청을 처리하는 RESTful API를 개발 중입니다.

내가 더 잘 사용 사례를 설명하려고 :이 API는 특정 상품의 최신 가격을 반환하는 특정 시장에서합니다 (는이 하나 개의 매개 변수입니다 commodity_id)합니다 (는이 두 번째 매개 변수입니다 market_id).

그럼이 추천을위한 유효한 URI 템플릿은 무엇입니까? 이 같은

뭔가 :

이 같은

/latest_commodity_price/{commodity_id}/{market_id} 

또는 무언가 :

/latest_commodity_price/{commodity_id}?market_id={market_id} 

또는 뭔가 같은 :

/latest_commodity_price?commodity_id={commodity_id}&market_id={market_id} 

아니면 무엇?

Answer 1

RESTful 방법으로 접근법이 잘못된 위치에서 시작됩니다. REST는 리소스를 쿼리하고 있음을 의미합니다. 따라서 URI는 API를 쿼리하는 리소스로 시작해야합니다.

/commodity/{commondity_id} 

그런 다음 시장 가격 목록을 원합니다. 당신 같은이 소리는 상품에 대한 가격 목록을 검색하기 위해 API를 조회 :

/commodity/{commondity_id}/prices 

가 마지막으로 가격의 목록을 필터링하고 있습니다. 검색어 매개 변수를 사용하여 필터링하는 것이 좋습니다.

/commodity/{commondity_id}/prices?market_id={market_id}&latestPrice=1