写了支持 go 后端框架的 swagger-ui 包,你会用它平替 swagger-ui 吗,不好用你拿屠龙刀砍我

234 天前
 rookie2luochao

不好用的话,请狠狠的提 issue 、pr, 欢迎各位大佬一起来建设 UI 和功能, 欢迎 star, fork, pr , 谢谢各位

代码仓库地址如下: golang 版本仓库 openapi-ui 基础仓库

2253 次点击
所在节点    程序员
11 条回复
hailaz
234 天前
我们早就内置了,不需要额外支持,哈哈哈
https://goframe.org/pages/viewpage.action?pageId=40219890
ZackKing
234 天前
@hailaz GF 大法好, 就是特殊需求不好改
rookie2luochao
234 天前
@hailaz 可是 redocly 都无法测试接口,阅读体验也没有我写的这个好,不信你可以体验一下,你们当真有为前端和测试同学提前测试接口考虑过吗😂😂😂
rookie2luochao
234 天前
@hailaz 我看你的框架下面有人吐槽:新版本的 swagger 最好支持在线发送请求,这样方便前端开发人员测试接口
rookie2luochao
234 天前
@hailaz 说明群众的眼睛是雪亮的,redocly 为什么不加测试接口的功能,确实无法理解😂
hailaz
234 天前
@rookie2luochao 额,支持自定义 ui 的
rookie2luochao
234 天前
@hailaz 支持自定义接口请求功能吗?那为啥我看接入 redocly 的都没有自定义过呢,这就尴尬了
rookie2luochao
234 天前
@hailaz 我看你们管理员的回复都是:gf 2.0.1 之后,文档 UI 使用的 redoc, redoc 没有 try it console 。如果想使用旧版的 swaggerUI ,可以使用 gf v2.0.0-rc3 版本
hailaz
234 天前
@rookie2luochao 嗯,我更新一下文档。现在自定义挺简单的 https://github.com/gogf/gf/blob/5307f0742e3e106f82e5e7cf81b4880089029575/example/httpserver/swagger-set-template/main.go
另外我刚刚试了下你们的 ui ,不确定是什么原因,解析不了。
https://github.com/rookie-luochao/openapi-ui/issues/177
rookie2luochao
234 天前
@hailaz 是你理解的必须带 tag ,我接触过的 swagger.json 定义都是有 tag 的,这让我误以为 tag 字段是必带的,但最重要的原因是我并没有去仔细阅读 swagger 的定义规范
rookie2luochao
234 天前
@hailaz 还有一点细节是譬如 swaggo 这类 swagger 的代码级实现,生成的是 swagger2 的文档,然后用工具转的 openapi3 ,go 的转换工具转的细节处理的并不是很好,比如 formdata 上传文件的定义转的是有问题的

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/1038275

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX