我应该为批量CRUD操作REST创建单独的端点吗?

问题描述 投票:0回答:1

如果我想同时支持REST API中的单个和批量创建,更新,删除操作,则有两个选择:

为单个操作和批量操作创建单个端点,例如:

POST docs/
{content...}

POST docs/
[
    {content...},
    {content..,}
]

或为单个操作和批量操作创建单独的端点,例如:

POST docs/
{content...}

POST docs/bulk
[
    {content...},
    {content...}
]  

哪种选择在以下方面更好:REST准则和设计原则,为什么?非常感谢。

rest api api-design
1个回答
0
投票

Josh所述,REST不提供有关资源设计的指导。可以命名的任何信息都可以是资源,所有资源应以相同的方式理解消息。

HTTP并没有更好;它在不鼓励任何特定资源设计的情况下定义消息语义。

[当您修改single资源时,HTTP鼓励您以间接方式POST到该资源-cache invalidation的规则表明哪个资源的本地缓存表示形式应无效。

但是我们尚未标准化使任意资源无效的通用机制。这意味着您无法将缓存语义传达给通用HTTP组件。

© www.soinside.com 2019 - 2024. All rights reserved.