1

正如您现在可能看到的那样,Loopbackjs 框架显示了一个基于 swagger 的浏览器界面,公开您的 API 端点并简要解释这些方法。问题是这个界面有点太多的交互性。

我需要为我的 API 提供一个 api-docs (ish) 文档,我目前正在 /common/models js 文件中添加 @annotations,但我怀疑我在这里重新发明了轮子。为了让 swagger-ui / loopback-explorer 显示其界面,端点必须已经暴露了某种元数据,对吧?

我想得到它并用描述、示例、自定义状态代码来完成它,并且没有“尝试”按钮。看到这一点的用户不会欣赏这么多的交互性。

4

1 回答 1

2

您可以通过单击 LoopBack Explorer 中任何模型最右侧的“原始”按钮来访问 LoopBack 模型的“swagger”,您将看到描述您的模型的 swagger JSON。

如果您真的想自定义您的 API 浏览器界面,请查看这篇文章:

http://www.podstud.io/blog/angular-swagger-jacking/

然后,您将访问 Model Swagger 资源并提供您想要的任何类型的流畅界面......

希望这能让你朝着正确的方向前进……

于 2014-10-08T18:18:47.377 回答