api - REST API 命名约定

Question

鉴于此 URI：

/myapp/books/status/{status}

例如 ：

/myapp/books/status/new 

这将返回所有标记有此状态的书籍。

返回所有未标记为特定状态的书籍的正确 URI 是什么？

/myapp/books/notstatus/new

我想归还所有书籍的集合，除了具有特定状态的书籍..

请指教...

Answer 1

我建议使用查询参数来过滤您的图书列表资源的状态：

myapp/books/?status=new
myapp/books/?status=not_new

两个查询都返回相同的资源（书籍列表），您只是在该列表中过滤掉您想要的类型，因此使用查询参数是有意义的。我使用not_状态前缀来进行反向查询，但您可以使用任何您想要的约定。

REST 不要求您避免获取参数（似乎有些人认为获取参数是巫毒），只是不要使用它们进行虚假 RPC 调用:)

我喜欢这种方法的原因是，当您可能想要为所有包含多条信息的书籍添加检查时，它会打开您的选项，例如状态为新且状况良好的书籍。

    myapp/books/?status=new&condition=good

如果您尝试将其分解为 url 段而不是查询参数，它会很快变得混乱。

Answer 2

据我所知，有几种方法，它们都是正确的（从 REST 角度来看）：

• 查询字符串参数

myapp/books?status=new

• OData 查询 http://www.odata.org/documentation/uri-conventions

myapp/books?$filter=status eq 'new'

• 在URI中，也不错

我的应用程序/书籍/状态/{状态}

我个人更喜欢查询字符串或 OData。

当技术特定（ASP.NET Web API、WCF 数据服务，由非 Microsoft 提供的服务也应该是等效的）有助于避免为此类查询编写任何代码时，OData 尤其有用。

它允许公开预过滤的集合，然后使用此类查询从客户端过滤它。在公开集合的这种情况下，我使用 OData 查询。