google-app-engine - 从 Java Cloud Endpoint 生成 API 文档

Question

我正在寻找一种有效的方法来从 Cloud Endpoint (Java) 生成的文件中生成可读格式的 API 文档。生成的文件是： - my_api.api - my_api*.discovery

看起来像这样的东西： - https://github.com/kevinrenskers/raml2html#example-output

Swagger、API blueprint 和 RAML 都是不错的选择，但似乎不能很好地适应端点生成的 API 描述符文件。

你使用什么方法？

Answer 1

不幸的是，我们（Apiary）目前实际上并没有为 API 蓝图提供任何代码生成工具。

如果您正在寻找一种如何从代码生成 API 描述的方法，那么 API 蓝图可能不是最佳选择，因为我们认为它应该代表参与 API 设计生命周期的每个人之间的契约。这也是我们搭建测试工具——Dredd—— https://github.com/apiaryio/dredd的原因

使用 Dredd，您可以测试您的 API 实现是否与您的蓝图匹配。如果蓝图是从实现中生成的，那将没有多大意义。

希望它澄清。