宁静的回复是否包括或排除空结果?

时间:2017-05-23 01:47:47

标签: rest response

这是一个api,它使用一批用户ID来获取用户

GET / user / {user_id}

user_id 以逗号分隔的字符串

例如 http://user.example.com/user/1,2,3

现在我在id 1和2中有2个用户,但没有id为3的用户。

响应是否包括空用户或排除?

包含示例:

{ "id":"1", "name":"Chris", "age":29 }, { "id":"2", "name":"Max", "age":30 }, { "id":"3" }

排除示例:

{ "id":"1", "name":"Chris", "age":29 }, { "id":"2", "name":"Max", "age":30 }

1 个答案:

答案 0 :(得分:0)

如果没有具有给定标识符的资源,则不得将其包含在响应中。

如果您有一组用户,请尝试使用复数名词/users而不是/user)来识别它,并使用查询字符串参数对其进行过滤,例如/users?ids=1,2,3

使用JSON表示集合时,请使用数组(以[开头,以]结尾,并将值与,分开)。

有关请求表示集合或单个资源的表示时应使用的状态代码的更多详细信息,请参阅此answer