什么说关于GET资源的良好实践

时间:2015-06-13 12:41:33

标签: rest restful-url

我想知道什么是好的做法可以创建 REST API 。我是否应该创建允许获取的URI几个特定用户?

例如我的意思是:

/usermanagement/users/{j_goldman,wafik,morder}

此uri将为 j_goldman,wafik morder 返回 3个对象用户。

2 个答案:

答案 0 :(得分:0)

你可以这样做,但它不会是宁静的恕我直言。如果你真的需要这样做,你应该考虑重新构建你的资源选择说,你想要获得的所有三个用户都属于id为111的特定组。然后你可以做/ groups / 111 GET之类的事情。如果你不能,那么我猜你应该坚持使用restful解决方案并使用三个API调用来分别获取用户。

答案 1 :(得分:0)

您正在做的是搜索特定的一组用户。通过URL中的查询参数,您可以实现此目的。

要返回单个用户(id为5):

  

/ usermanagement /用户/ 5

要返回所有用户:

  

/ usermanagement /用户

根据搜索返回一组用户:

  

/ usermanagement /用户?用户名=

这样,您的API可以按指定的条件进行搜索,也可以进行扩展。

说,您希望按位置搜索:

  

/ usermanagement /用户?位置=

说,你希望将这些结合起来:

  ?

/ usermanagement /用户的用户名= {标准}&安培;位置= {标准}

您可能还希望公开搜索端点本身:

  

/ usermanagement /搜索

您也可以在这里找到其他选项:

RESTful URL design for search