rest - 如果请求的字段不存在，则正确的REST响应

Question

如果未设置fields，我将返回所有可能的汽车字段。如果给定fields一个数组，我只返回那些字段。例如，以下查询:

curl -X GET 'http://example.com/api/cars?fields=name&fields=color&fields=cost'

应该返回所有汽车列表 [{"name":"Ford", "color":"blue", "cost":10000},...]。

现在，另一个要求，但是这次还包括汽车的功率。

curl -X GET 'http://example.com/api/cars?fields=name&fields=color&fields=cost&fields=hp'

但是应用程序不支持马力。我是不是该:

仅返回什么可能？即[{"name":"Ford", "color":"blue", "cost":10000},...]

返回所有请求的字段，但包括不支持字段的null，即[{"name":"Ford", "color":"blue", "cost":10000, "hp":null},...]

不返回任何结果，但是返回错误？

还有其他事情吗？

Answer 1

我将返回一个HTTP错误代码400 Bad request以及一个错误的JSON对象(例如{"error":"Unknown field: 'horsepower'"})，因为您实际上并不知道客户端想要做什么。也许他们要求的字段不存在，或者他们在其中一个字段中犯了拼写错误。

如果您默默地忽略该错误，客户端将很难检测到该错误。最好只返回一个错误，然后让客户端处理。