我正在关注swagger驱动的api开发。在浏览代码库时,我观察到只要期望返回对象列表,服务就会返回父对象。
给出的原因是"在api中返回对象列表是一种糟糕的做法"。这个受欢迎的教程很可能是灵感的来源:-https://www.youtube.com/watch?v=Dmvhe2cw-_k它说,如果服务返回一个对象而不是一个列表,api可能会中断
然而,我不相信这种一刀切的格言,因为每一个api合同都是用swagger文档记录的,所有开发人员都必须严格遵循该文档来开发他们的服务和服务调用。
与返回包装器对象相比,我仍然更喜欢返回对象列表。专家们有什么建议?
我们非常感谢任何文档的链接、最佳实践的开发人员指南。
如果它是"集合"资源,例如:
/employees
然后,作为一名消费者,我希望得到一份物品清单+任何分页详细信息(如果你提供一些查询参数等,那么收到一些符合条件的员工总数的汇总信息也会非常有帮助(
本指南应帮助您更多地了解不同类型的资源https://restfulapi.net/resource-naming/