具有任意数量过滤条件的搜索服务的 RESTful URL

Question

我想构建一个 RESTful Web 服务，为生物数据数据库实现搜索界面。

一个典型的搜索请求可能涉及十几个数据属性。例如，按学名搜索，将搜索限制在小于 100m 的水深。我的第一直觉是在查询字符串中包含所有属性例如?searchType=sciname&sciname=mola+mola&maxdepth=100&mindepth=0

但是，查询字符串被视为非 RESTful，请参阅 http://rest.blueoxen.net/cgi-bin/wiki.pl?QueryStringsConsideredHarmful

我看过一些早期的 SO 讨论，例如 RESTful URL design for search我仍然不清楚这一点，所以我的问题是:

对于可能存在任意数量的搜索服务的 RESTful URL，是否有公认的标准或模式过滤值？

Answer 1

在 Web 的 REST 风格中:

• request-uri 的 path 组件标识特定资源。
• request-uri 的 query-string 组件标识在呈现该资源时所做的任何特定过滤器或更改。
• Accept header 标识了一个特定的内容类型，在该内容类型中，应按指定过滤给定资源。
• Accept-Language header 标识一种特定语言，按照指定过滤后的给定资源应以该语言呈现。

所以回答你的问题:

GET /species?searchType=sciname&sciname=mola+mola&maxdepth=100&mindepth=0

非常合适。