REST API Параметр приоритет

Question

Я работаю над созданием REST API.Допустим, ресурс, который я обслуживаю, называется object и содержит ряд свойств.

Помимо запроса всего набора объектов, подобных этому

GET api.example.com/objects

Я хочу разрешить запрашивать отдельный объект, указав objectid или objectname, например:

GET api.example.com/objects?objectid=<br> GET api.example.com/objects?objectname=

Что меня смущает, так это какобрабатывать такой запрос?

GET api.example.com/objects?objectid=x&objectname=y

В этом случае я должен вернуть 400 Bad Request или один из параметров должен иметь приоритет над другим?Как REST определяет это поведение?

Answer 1

REST обычно предполагает наличие уникального URL для ресурса, поэтому он будет выглядеть следующим образом:

GET api.example.com/objects/objectId

Параметры обычно используются для поиска, поэтому у вас будет что-то вроде:

GET api.example.com/objects?objectName=x

Answer 2

Лучшим подходом будет использование универсального ключа в строке параметров для получения значений полей вашего конкретного ресурса

GET api.example.com/objects/objectId?field=objectName,anotherField

Он дополняет предложение xpapad и может добавить масштабируемую структуру в том, как вы определяете согласованный подходк вашему дизайну API.