HATEOAS超媒体的运行时发现？

Answer 1

正如@voicesofunreason所说，在HATEOAS中，URI是可发现的（并且没有文档化），因此可以更改它们。也就是说，除非它们是进入系统的入口点（很酷的URI，唯一可以由客户机硬编码的URI)--如果您希望将来能够改进系统URI结构的其余部分，那么就不应该有太多的入口点。这实际上是REST最有用的特性之一。

对于剩余的非酷URI，它们可以随着时间的推移而更改，您的API文档应该详细说明应该在运行时通过超媒体遍历发现它们。

看看理查森的成熟度模型（第3级），这将是链接发挥作用的地方。例如，从顶层，例如/api/version(/1)，您会发现有一个到组的链接。以下是在HAL Browser这样的工具中的外观：

{
  "_links": {
    "self": {
      "href": "/api/root"
    },
    "api:group-add": {
      "href": "http://apiname:port/api/group"
    },
    "api:group-search": {
      "href": "http://apiname:port/api/group?pageNumber={pageNumber}&pageSize={pageSize}&sort={sort}"
    },
    "api:group-by-id": {
      "href": "http://apiname:port/api/group/id" (OR "href": "http://apiname:port/api/group?id={id}")
    }
  }
}

{
    "groups": [
      {
        "id": 123,
        "name": "Test Group"
      }, 
      {
        "id": 134,
        "name": "Tennis squad"
      }
    ]
}

然后，一旦你深入到一个特定的群体（比如#123):

{
  "Id" : 123,
  "Name" : "test",
  "_links": {
    "self": {
      "href": "/api/group/1" (OR "/api/group?id=1")
    },
    "edit": {
      "href": "http://apiname:port/api/group/1"
    },
    "api:delete": {
      "href": "http://apiname:port/api/group/1"
    },
    "api:items-query": {
      "href": "http://apiname:port/api/bonus?groupId=1"
    }
  }
}

在这里，编辑只是一个PUT，然后您需要一个DELETE（请参见同一链接中的REST级别2)，对于项，您可能最清楚它们是一个属性还是另一个endpoint；您甚至可以将它们嵌入到检索组的同一个调用中返回。

这里的优点是客户机只需要知道关系（链接）名称（显然除了资源结构/属性之外），而服务器基本上可以自由地更改关系（和资源）URL。