Web services REST设计-获取一组精简资源

Web services REST设计-获取一组精简资源,web-services,rest,restful-url,Web Services,Rest,Restful Url,我有一个web服务来检索我的用户列表:/users 我的用户实体有很多属性(有很多关系,如角色、地址等),检索整个列表开始让人痛苦 我想创建一个新的web服务来检索最小用户DTO的列表。此DTO仅包含用户名、名字和姓氏 你对这个新URI有什么建议 /users-minimal /users/minimal /users/func/get-minimal ... ? 如果改变的仅仅是表示,那么应该将其作为不同的媒体类型而不是不同的URI提供。例如,对于普通用户,如果您有application/v

我有一个web服务来检索我的用户列表:/users

我的用户实体有很多属性(有很多关系,如角色、地址等),检索整个列表开始让人痛苦

我想创建一个新的web服务来检索最小用户DTO的列表。此DTO仅包含用户名、名字和姓氏

你对这个新URI有什么建议

/users-minimal
/users/minimal
/users/func/get-minimal
... ?

如果改变的仅仅是表示,那么应该将其作为不同的媒体类型而不是不同的URI提供。例如,对于普通用户,如果您有
application/vnd.mycompany.user.v1+json
,那么对于最小值,您可以使用
application/vnd.mycompany.user minimal.v1+json


现在,您可能不会像上面那样使用自定义媒体类型,如果您询问RESTful URI,您可能也不会使用HATEOAS。对于像HTTP API这样的REST,您可能应该改用querystring参数。类似于
/users?minimal=1
/users/?fields=username,first\u name,last\u name

谢谢你,佩德罗,我将采用解决方案/users/?fields=username,first\u name,last\u name。