REST - 资源和集合表示

Question

我对收藏资源的设计感到困惑。
假设我有一个用户资源 - 如下所示。

http://www.example.com/users/{user-id}
user : {
  id : "",
  name : "",
  age : "",
  addresses : [
    {
      line1 : "",
      line2 : "",
      city : "",
      state : "",
      country : "",
      zip : ""
    }
  ]
}



现在，我的用户集合资源表示应该如何？它应该是用户表示的列表(如上所述)吗？或者它可以是如下所示的子集:

http://www.example.com/users/
users : [
  {
    id : "",
    name : "",
    link : {
      rel : "self",
      href : "/users/{id}"
    }
  }
]



集合资源表示应该包括包含资源的完整表示还是可以是一个子集？

Answer 1

媒体类型定义了如何传达信息的规则。查看Collection+JSON的规范和 HAL有关如何做您正在尝试做的事情的示例。