json-ld - 对新 API 使用 swagger 文档或 Hydra:ApiDocumentation

Question

我目前正在选择一种技术/格式来公开我的 API。似乎有很多关于这个主题的讨论，但找不到一个以供将来使用。我打算使用Hydra：

http://www.markus-lanthaler.com/hydra

因为它似乎完全休息（超媒体 api），但它似乎还没有被接受（HAL也不是）。

当我去：http://www.markus-lanthaler.com/hydra/api-demo/vocab时，我得到一个似乎是招摇返回的json。

我的问题： - Hydra 文档是否意味着像招摇一样 - 可以像招摇一样找到任何工具。- 我更喜欢使用 Hydra，因为它似乎对操作有更多描述......通过使用 json-ld，但它似乎不像 Hal 或 swagger 那样受支持。- 有没有人有 hydra 的经验

Answer 1

太好了，您考虑使用 Hydra。你说得对，我们还没有广泛的工具，但这只是时间问题。事实上，我已经在研究文档生成器了。如果您对 Hydra 有其他疑问，请随时发布到我们的邮件列表。名单上有很多人很乐意提供帮助。