REST API设计:当api必须返回字段的相等性和非相等性列表时,如何处理?

时间:2018-10-23 15:30:44

标签: rest api api-design

例如: REST端点必须列出分配给特定推销员的汽车,然后显示可能分配给其他推销员的剩余物品(由特定推销员排序)的情况。因此它具有两组数据。 1)等于受让人 2)不等于受让人 P.S List端点返回分页的响应(受页数限制) 可以通过一个端点来实现吗?那甚至可行吗? REST标准对这种情况有何规定?

1 个答案:

答案 0 :(得分:0)

  

REST端点必须列出分配给特定推销员的汽车,然后显示可能分配给其他推销员的剩余物品(由特定推销员排序)的情况。因此它具有两组数据。 1)等于受让人2)不等于受让人

您将如何处理网站?

您可能会获取一些目标资源,它将返回HTML表示,销售人员的汽车在页面顶部,其余项目在页面底部。

这样就可以了。对于每个推销员,您将拥有不同的资源(生成的文档在语义上是不同的),但是您的基本表示形式可能会使用一条从URI中解析特定推销员的路由来实现这一目标。

  

列表端点返回分页的响应

这并没有太大变化-每个页面都是一个不同的资源,但是您的路由仍然可以从URI中解析出重要信息。如果您为任何非特定于资源的参数准备了默认值,那么您将可以使用。

对于HTML表示形式,您可能会在表示形式中包括分页链接。您还可以选择在响应标题中描述链接,以供了解这一点的客户端使用。

您的实现需要了解如何计算所支持的每个链接(第一个,最后一个,上一个,下一个)要使用的不同URI的拼写。

以下参考文献可能会有所帮助