ОТДЫХ идиома для под-коллекции?

Question

Мое понимание REST (по общему признанию, ограниченное в значительной степени страницей википедии ) состоит в том, что идиома для GET создания коллекции - ../resource/, а элемент - ../resource/itemId.

Существует ли стандартная идиома для GET ing для подгруппы? Например, если элементы в коллекции имеют некоторый переключатель состояния (скажем, состояния A, B, C, D), и я хочу иметь возможность запрашивать элементы с состоянием B, есть ли стандартный / общий / наилучший способ сделать что?

Если нет, то в настоящее время я использую следующие параметры синтаксиса:

../resource/B

../resource/state/B

../resource?state=B

Какие плюсы / минусы тех вы видите?

Answer 1

Вы хотите использовать третий, кроме множественного числа (поскольку вы получаете более одного)

../resources?state=B

Потому что это точно описывает, что вы хотите. Вы GET используете ресурс с определенным состоянием.

../resource/B

Указывает, что вы получаете конкретный ресурс, уникально идентифицируемый B

../resource/state/B

Указывает, что вы получаете ресурс state, принадлежащий resource, уникально идентифицируемый как B.

Альтернативой, если вы имеете дело с конечным числом состояний, было бы сделать ресурс самим по себе и сделать ресурс дочерним по отношению к этому состоянию. Тогда у вас будет

states/B/resources

Answer 2

Ограничения REST фактически ничего не говорят о том, как вы называете ресурсы. REST просто говорит, что у ресурсов должно быть имя.

Сказав это, ответ Джейми, вероятно, является наиболее очевидным способом сделать это. Вы можете сравнить URL-адреса именования с процедурами именования, нет правильного и неправильного способа сделать это, просто некоторые имена более очевидны, чем другие.