在 HAL 讨论论坛https://groups.google.com/forum/#!forum/hal-discuss
不返回动词的事实是您使用的超媒体格式的决定,我猜是 HAL(或者可能是集合 + json)。某些格式确实包含动词信息。
如果您愿意,HAL 实际上允许您在链接对象上包含自定义字段,但我不鼓励这样做,因为任何标准客户端都不知道如何解释这一点。
但我也发现这个动词最终毫无价值。
首先在人类 2 机器中,用户将阅读文档。HAL 将所有链接取消引用(通过 CURIE,因为它们目前是 naemd)到人类可读的文档,这些文档应该描述使用不同参数、动词、标题等请求链接的效果。
接下来是为了让您的应用程序真正成为 RESTful,您应该响应所有动词……您可能只是不响应动词没问题。对于基于 HTTP 的应用程序返回 405 是非常合适的。返回 404 不是!500会更糟!您的 405 应包括可用于所请求资源的方法。
接下来,在机器 2 机器(和一点 h2m)的情况下,当通过 HTTP 访问您的应用程序时(我尽量避免在我的答案中使用 http,因为 RESTful 应用程序不一定是 HTTP ..虽然我会说 101% 是) 应该对资源 URL 使用 OPTIONS 方法 ( http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html ) 以获得可能的描述。
这是我看到很多人被绊倒的地方,OPTIONS 的反应应该是什么?人们忘记的是内容类型协商!请求者应该说明他们期望的选项信息格式。接受:some-machine-language/xml 或 application/language+json。一些 RFC 或标准定义了这些内容类型,您的 API 可以识别它支持的格式。我建议您包括对 text/html 的支持,以便您可以返回人类可读的文档以及支持哪些动词。这很好地涵盖了 h2m 场景。
在返回有关不受支持的方法的信息时,相同的内容类型协商可能很有用。服务器可以发送客户端可以理解的内容类型,该内容类型在语义上描述了允许的方法。
我想指出的最后一件事是方法暗示了客户的意图。我想放置这个资源或删除那个资源。服务器应该接受请求并返回响应表明由于该请求而发生的状态转换。因此,让 API 在每个请求中识别客户端的可能意图有点愚蠢。客户知道它想做什么,它应该尝试,如果它不能,那么它应该处理它。