请求收集时的简单模型和请求资源时的扩展模型 - 如何

时间:2015-06-11 10:21:10

标签: rest architecture restful-architecture

我有以下URI:/articles/:id,其中article是Web服务上的资源,并且具有关联的模型/类。现在,我需要在请求收集时仅返回每个资源的部分数据(以节省带宽并提高速度),但是当从集合中请求单个项目时,我需要发送完整数据。我的问题是我应该在服务器上为同一资源使用两个模型/类,并根据集合或单个资源请求启动不同的模型/类吗?或者也许应该只有一个模型/类,但是当请求集合时,不应该用数据填充所有字段?或许还有另一种方法?

1 个答案:

答案 0 :(得分:1)

我建议使用建议here的方法和fields查询参数。

如果API将向所有人开放并且客户端使用将无法预测,那么默认情况下您可能需要限制返回的字段。只要确保以某种方式记录可以使用的所有可能字段,以防客户实际需要它们。

如果API仅由您制作的应用程序或应用程序使用,那么默认情况下您可以返回所有字段,然后您的应用程序可以传递fields参数以加快速度。