rest - 树结构的 REST API 设计指南

Question

我正在设计用于添加和检索树型结构的 REST API。设计如下

---

用户界面

Tree Root - Header - # need to display total node weight and aggregated data
    - Node
        - Node
    - Node 
        - Node
        - Node

Node {
 int weight, 
 // large object
}

---

API

GET:    /tree/{id}

仅返回树级别 1 节点

GET:    /tree/{treeid}/nodes/{nodeid}

返回子节点

POST: /tree/{treeid}/node

添加/更新新节点

我可以从这里返回带有标题的树根吗？

理想情况下，它（POST）应该返回新创建的资源。

要保存两个 API 调用（一个用于保存 Node，另一个用于标头），我可以将 Node 数据与标头数据一起返回吗？

标签： restuser-interface