RESTful URL 搜索风格指南

Question

如果允许在单个查询参数上放置多个值，

参数名称应该是单数形式还是复数形式？

/user?status=1,2,3

对

/user?statuses=1,2,3

我试过google但没有人讨论这个具体问题

Answer 1

由于您的端点允许用户查询多种状态，因此您将使用复数状态，即

/user?statuses=1,2,3

如果您的端点仅允许用户查询单一状态，您将使用单数，即

/user?status=1