在过滤的 API Restful 资源中添加子类别

Question

我将举一个例子，因为标题可能听起来有点混乱。

如何为类似的东西构建资源路径：

GET /courses/?language=english&active=true/units

我想过滤课程（通常不使用 id），然后获取此结果的单位。你会怎么做？我想在路径之间使用问号是不允许的。

Answer 1

这在一定程度上取决于您的数据库架构什么是“课程”和“单元”。使用 RESTful 方式的重点是始终构建特定于资源的请求和 url。

但是假设一门课程上有 X 个单元。以下是我为该请求创建 RESTful 路径的方法：

由于过滤课程和使用 /unit 后缀的路径问题，可以通过添加另一个查询参数来完成，该参数指定请求应该返回哪些字段。像这样的：

GET /courses?language=english&active=true&fields=units

这将过滤课程，然后在响应中仅返回“单位”字段。正如我所说，根据您的数据库和模型，如果这些单元没有存储在课程中，那么通过请求 /courses 路径来获取它们将是一个不好的做法。在这种情况下，首先请求匹配所需过滤器的课程，然后向 /units 上下文发出另一个请求，发送即课程 ID 作为查询参数。