设计一个RESTful api，用于立即创建一个资源及其相关资源

Question

我想知道如何设计一个RESTFUL api，用于一次性创建一个资源及其相关资源。

例如，我想使用RESTFUL API创建一个包含项目列表的订单，例如：

{
    order_id:1,
    description: "XXX",
    items: [
        {item_id:1, price:30, ...},
        {item_id:2, price:40, ...}
    ]
}

null

那么，将项目放在请求正文中，并只向api/orders发布一次是一种好方法吗？还是针对这种情况有其他更好的设计？

谢谢你！

Answer 1

我想知道如何设计一个RESTFUL api，用于一次性创建一个资源及其相关资源。

完全合理的做法。将您的注意力集中在如何向客户描述如何创建适当的请求，以及如何解释描述结果的文档上。

线索在201创建状态码的定义中

它必须是HTML吗？不，当然不是--如果适合您的需要，您可以使用text/plain。当使用一种媒体类型时，您会有更好的长期前景，因为该媒体类型内置了通用组件可以理解的链接概念。