Ruby on rails 建议使用接受嵌套对象作为参数的RESTAPI吗？

我正在开发一个restful API。我的createreservation方法需要数据、位置等参数。它还需要一个人员列表。那些人有名字、生日等

因此，要将人员传递给API，我需要向API发送一个嵌套对象。这是API世界中我通常看不到的东西

---

所以我的问题是：这有什么问题吗？我应该以某种方式展平参数对象吗？或者接受嵌套对象作为参数完全没有问题吗？

这不会有问题，但通常不可取，因为API的使用者在调用时需要理解嵌套的JSON和构造。具有简单请求JSON和语法的API总是可取的。

这种策略完全与建模和与信息生成系统的耦合有关

在我的观点中，如果资源可以按顺序作为子资源进行结构化，那么导航和可恢复性就变得更有趣了。为了最大限度地减少调用次数，当今企业几乎都在使用一种设计模式

例如：

• POST-->这将创建一个新的客户端资源并返回新的客户端标识
• 职位

---

我一直看到这一点。如果API需要一个集合，那么它们将获取所需的内容。反对它的理由是，实际上您有两个端点：一个用于创建资源，另一个用于添加其每个子资源。