rest - 如何设计一个查询，从中检索要以 RESTful 方式应用过滤器的资源的最后数据？

Question

当我想从未删除的 installations 中检索最后的 measurements 时，查询应该是什么样的？

类似的东西？

/my-web-service/installations/measurements/last?removed=false

问题是，我不想检索未从 installations 中删除的最后一个 measurements。我想从未删除的 installations 中检索最后的 measurements。

Answer 1

我在这里看到了几种可能性:

1. 如果您需要从端点事务性读取数据，您设计它的方式就是可行的方法。我要更改的是 removed 中的参数名称至 installationRemoved因为它更具描述性并将端点缩短为 /my-web-service/measurements/ - 自从 installations目前尚不清楚客户在哪个范围内运作。另外，你不需要since吗？过滤最后测量值的参数？

2. 如果有机会拆分我要添加的两个端点:

   • /my-web-service/installations/?removed=false
   • /my-web-service/measurements/?since=timestamp&installations=<array>

   它不会让事情变得更好(当谈到更好或更坏时)，但对用户来说更容易和更具预测性。

一般来说，尝试添加更多具有过滤选项的通用端点，而不是高度专用的端点 - 做一件特定的事情。这种方式导致难以使用、松散的 API。此外，关于 filtering .

最后请注意，如果您的客户不是因为必须使用它而是在他们喜欢的时候使用它，那么您的 API 就是好的 ;)