在微服务RESTapi调用中返回对象列表是不是一种糟糕的做法



我正在关注swagger驱动的api开发。在浏览代码库时,我观察到只要期望返回对象列表,服务就会返回父对象。

给出的原因是"在api中返回对象列表是一种糟糕的做法"。这个受欢迎的教程很可能是灵感的来源:-https://www.youtube.com/watch?v=Dmvhe2cw-_k它说,如果服务返回一个对象而不是一个列表,api可能会中断

然而,我不相信这种一刀切的格言,因为每一个api合同都是用swagger文档记录的,所有开发人员都必须严格遵循该文档来开发他们的服务和服务调用。

与返回包装器对象相比,我仍然更喜欢返回对象列表。专家们有什么建议?

我们非常感谢任何文档的链接、最佳实践的开发人员指南。

如果它是"集合"资源,例如:

/employees

然后,作为一名消费者,我希望得到一份物品清单+任何分页详细信息(如果你提供一些查询参数等,那么收到一些符合条件的员工总数的汇总信息也会非常有帮助(

本指南应帮助您更多地了解不同类型的资源https://restfulapi.net/resource-naming/

相关内容

最新更新