用于单一和批量资源创建的多个端点

Question

我目前正在实现REST，对于某些资源子集来说，该API需要同时支持所述资源的单次和批量创建。我试图决定是否有必要公开两个不同的端点:一个用于单数创建，另一个用于批量创建。

例如，假设我有一个地址资源。我可以通过POSTing创建一个地址，这是该资源到URI /address的表示。如果我想支持批量创建，那么让/address端点识别多个表示是否是该端点的POSTed，然后采取适当的操作(单数创建还是批量创建)更好，还是最好有一个完全独立的端点，只接受批量创建？

Answer 1

我的方法是允许向/addresses发送一个可以包含多个地址定义的对象。在后端，您遍历对象并创建一个或多个地址。所以身体就像：

<addresses>
    <address>
        <street>123 Maple Lane</street>
        <city>Newark</city>
        <state>NJ</state>
        <zip>00000</zip>
    </address>
    <address>
        <street>227 First Avenue</street>
        <city>Tulsa</city>
        <state>OK</state>
        <zip>00000</zip>
    </address>
</addresses>

我会避免单独的端点，因为没有理由这样做。如果您只在集合中张贴一个地址，则只创建一个地址。