当前位置: 首页 > 知识库问答 >
问题:

招摇过市的用户界面/编辑器式页面-添加到我的网站

井高峯
2023-03-14

我通过swagger编辑器手动创建了YAML文件(分别为JSON文件)。

现在我想将swagger编辑器工具中很酷的自动生成页面嵌入到我的网站中,以便用户可以实时阅读和测试它(通过“尝试此操作”按钮)我的API。

我不希望swagger为我生成任何代码,也不需要它自动更新文档(YAML或任何东西)。只要需要,我就会手动更新静态YAML/JSON文件。斯威格支持这种功能吗?它是否与swagger编辑器工具栏中的“生成客户端”相关?我正在寻找一些html/js/css文件,可以加载静态YAML文件并生成类似于swagger editor右侧页面的内容。顺便说一句,我使用的是Apache web服务器(没那么重要)。

谢谢

编辑:我只寻找客户端-一些可以添加上述要求的js/css/html,我不介意不时再次生成它(每当我更改我的YAML文件/我的REST API时)

共有2个答案

南门宇
2023-03-14

我想你在找斯威格服务器(https://github.com/BigstickCarpet/swagger-server).

齐栋
2023-03-14

嗯,我找到了我正在寻找的工具,它是swagger用户界面。它看起来并不完全像swagger编辑器右侧的UI,但它满足了我的要求——它在客户端在线解析我的JSON文件(我手动编写为YAML),只使用静态文件(没有服务器端工作,只提供页面)。

无论如何,谢谢!

编辑:我在下面的链接中发现更多的人对编辑器视图解决方案感兴趣

EDIT2:我添加了一个简短的肮脏的变通方法,只预览了swagger编辑器的相关部分。你可以在这里看到变化。你可以试试:

  1. 克隆我的分叉回购:git克隆http://github.com/itayB/swagger-editor.git
  2. cd-swagger编辑器
  3. npm安装
  4. npm启动

请注意:此预览显示了文件规范文件/default.yaml.我只做了一些视图更改,所有编辑器逻辑仍然落后。

干杯

 类似资料:
  • 我一直试图让斯威格在NGINX反向代理后工作,但我就是做不好。我的服务在docker容器中运行,我希望使用以下示例URL访问它们: 我的服务: 昂首阔步: 我的嵌套位置块如下所示: 我的NGINX日志如下所示: 直接测试这一点,而无需通过NGINX,该过程将继续进行,并获得/v2/api和/swagger资源。在这之前,使用反向代理会被卡住。 对此有何建议? 编辑:这里是一个NGINX日志,当不尝

  • 我试图通过Swagger UI记录在供应商产品(WSO2 ESB)中开发的现有API服务,以供公司内部使用。供应商产品不支持招摇过市。我计划以编程方式检查/处理API服务的源代码(编写在供应商产品中),并在中生成一个包含swagger定义文件的目录/文件夹/库。json或。yml格式。那很好,我能做到。 这些api定义文件中的每一个都将在swagger UI中很好地呈现,我正在考虑使用https:

  • 当我打开它时,所有操作都显示为折叠,并且我希望它在默认情况下展开。 有什么我需要改变的属性来实现它吗? 这是我的霸气豆:

  • 12.1 节用到了很多数据模型技术,可能要花些时间才能完全理解。其实,理解这些关联最好的方式是在网页界面中使用。 在本章的导言中,我们介绍了关注用户的操作流程。本节,我们要实现这些构思的页面,以及关注和取消关注功能。我们还会创建两个页面,分别列出我关注的用户和关注我的用户。在 12.3 节,我们会实现用户的动态流,届时,这个演示应用才算完成。 12.2.1 示例数据 和之前的几章一样,我们要使用

  • 6.1.2.编程式的用户界面 编程式的用户界面就是使用Java代码来编写UI,做过Java AWT或者Java Swing开发的同学对此肯定不会陌生。这跟其它语言中提供的UI库也区别不大。 假如你想通过编写代码的方式创建一个按钮,一般就需要声明一个按钮变量、获得按钮的实例、添加到容器里面,然后设置相应的属性——颜色、文本、文本大小、背景颜色等等不一而足。你也希望对按钮的点击事件做些响应,因此还需要

  • 我正在开发一个有点传统的API(Spring Boot)——它使用的是openapi 2.0版,它还使用pom中的插件。xml。 我最近参加了一个领英学习课程,我们使用斯瓦格编辑器(本地使用Docker)编写api规范(openapi 3.0),并用您选择的任何语言“导出”服务器存根,在这种情况下JavaSpring。我注意到Controller实现的API类已经在这个存根中生成了。然而,当使用s