RESTful API和stats页面

Question

我有一个管理客户和支付的RESTful API。

有人要求我创建一个stats页面，其数据如下：

• 客户总数
• 有多少客户是活跃/不活跃的？
• 付款总数
• 有多少付款失败/成功
• 每天有多少付款失败/成功
• 每月有多少付款失败/成功
• 每天挣多少钱
• 每月挣多少钱
• 和其他更多

我有所有东西的端点，我可以通过调用api/customers来检索调用api/payments和支付的客户。我知道我可以打电话给api/payments?status=successful和api/payments?status=failed来获取我所需要的数据，但是系统有数以百计的支付和成千上万的客户，每个查询都需要花时间来处理。而且，我知道我可以用一个group by语句的一个查询来检索所有的支付统计数据。

我的问题是:为每个所需的stat创建一个新的端点会打破RESTful的惯例吗？这将允许我为每个度量创建“优化”查询。

提前感谢

Answer 1

它会打破RESTful惯例为每个所需的stat创建一个新的端点吗？

不是的。

记住，休息建筑风格的参考应用程序是万维网。添加一个新的网页是一件非常正常的事情。资源也是如此。

Answer 2

RESTful只是API的一种架构风格。如果您阅读RFC，您会发现没有一个RESTful API是真正的RESTful。为了真正实现这样的API，有大量的建议。

我对您的问题的看法(以及答案)是，这样的体系结构更像是构建API的指南，而不是严格遵循它。软件工程是关于做出这样的决定，没有完美的答案，你只是选择权衡。