2

RESTful Web 服务 API 是使用 Restlet 实现的。我需要为这些生成 API 文档。我不是从单独的文档开始,而是评估是否可以从源代码注释本身生成。

我看着大摇大摆的口气。Swagger 似乎基于 JAX-RS 规范。Enunciate 看起来更有希望,因为有一个常见问题解答提到如何为非 JAX-RS 实现生成,但没有任何帮助。

  1. 是否有任何工具(或者如果社区使用过任何工具)从 Restlet 注释生成 API 文档?

  2. 有没有人将 Restlet 与 enunciate 集成以生成文档?

4

1 回答 1

1

Restlet 现在支持在运行时基于您的应用程序生成相应的 Swagger 和 RAML 内容的能力。

以下文档可以帮助您:

然后,您可以利用工具社区中的工具来生成您的 API 文档。您可以考虑 Swagger UI,它是一个很好的工具,可以在线显示 API 提供的内容并与之交互。

希望它可以帮助你,蒂埃里

于 2015-06-15T07:55:39.280 回答