api - RESTful API : how design URI, 通过查询字符串还是分层？

Question

我有一个“普通”的网络应用程序，我在其中列出了全局服务。
列出书籍的方法有两种:1) 使用搜索字段或 2) 使用分层路径设计。

示例 1) Seach 字段生成 URI，例如:
mysite.com/en/services?location=london&category=lowcost

示例 2) 路径如下:
mysite.com/en/services/uk/london/lowcost

这两个示例都列出了相同的服务。

但现在我必须编写一个 RESTful API。所以我的问题是:
我应该向我的 api 客户提供哪种接口(interface)/方式？我的意思是，他们应该只是通过使用查询字符串(示例 1)来请求我的数据，还是应该自己构建路径，这意味着他们应该知道，例如伦敦属于英国 :)(或 chiang-mai泰国) ...

提供两种方式是个好主意吗？
但是，如果我同时提供两者，那么 2 个资源(在本例中为集合)以相同的资源为目标是否是一个好的 RESTful API 设计？

Answer 1

路径名用于层次结构，查询字符串用于过滤。

如果它是命名对象的父类(super class)别，则它位于路径名中。

如果它唯一地标识了命名对象，那么它就是路径名的最后一个组成部分。

如果它是命名对象的属性或子对象，但不能唯一标识该对象，则它会进入查询字符串。