RESTful руководство по стилю URL для поиска

Question

Если разрешено помещать несколько значений в один параметр запроса,

должно ли имя параметра быть в форме единственного или множественного числа?

/user?status=1,2,3

против

/user?statuses=1,2,3

Я пытался гуглить, но никто не покрывает эту спецификацию c значения

Answer 1

Поскольку ваша конечная точка позволяет пользователю запрашивать несколько статусов, вы должны использовать множественное число статуса, например

/user?statuses=1,2,3

Если ваша конечная точка позволяет пользователю запрашивать только один статус, который вы бы используйте единственное число, т.е.

/user?status=1