V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
rookie2luochao
V2EX  ›  程序员

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

  •  
  •   rookie2luochao ·
    rookie-luochao · 201 天前 · 2204 次点击
    这是一个创建于 201 天前的主题,其中的信息可能已经有所发展或是发生改变。

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

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

    9.jpg 18.jpg

    11 条回复    2024-05-07 15:06:29 +08:00
    hailaz
        1
    hailaz  
       201 天前
    我们早就内置了,不需要额外支持,哈哈哈
    https://goframe.org/pages/viewpage.action?pageId=40219890
    ZackKing
        2
    ZackKing  
       201 天前
    @hailaz GF 大法好, 就是特殊需求不好改
    rookie2luochao
        3
    rookie2luochao  
    OP
       201 天前
    @hailaz 可是 redocly 都无法测试接口,阅读体验也没有我写的这个好,不信你可以体验一下,你们当真有为前端和测试同学提前测试接口考虑过吗😂😂😂
    rookie2luochao
        4
    rookie2luochao  
    OP
       201 天前
    @hailaz 我看你的框架下面有人吐槽:新版本的 swagger 最好支持在线发送请求,这样方便前端开发人员测试接口
    rookie2luochao
        5
    rookie2luochao  
    OP
       201 天前
    @hailaz 说明群众的眼睛是雪亮的,redocly 为什么不加测试接口的功能,确实无法理解😂
    hailaz
        6
    hailaz  
       201 天前
    @rookie2luochao 额,支持自定义 ui 的
    rookie2luochao
        7
    rookie2luochao  
    OP
       201 天前
    @hailaz 支持自定义接口请求功能吗?那为啥我看接入 redocly 的都没有自定义过呢,这就尴尬了
    rookie2luochao
        8
    rookie2luochao  
    OP
       201 天前
    @hailaz 我看你们管理员的回复都是:gf 2.0.1 之后,文档 UI 使用的 redoc, redoc 没有 try it console 。如果想使用旧版的 swaggerUI ,可以使用 gf v2.0.0-rc3 版本
    hailaz
        9
    hailaz  
       201 天前
    @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
        10
    rookie2luochao  
    OP
       201 天前
    @hailaz 是你理解的必须带 tag ,我接触过的 swagger.json 定义都是有 tag 的,这让我误以为 tag 字段是必带的,但最重要的原因是我并没有去仔细阅读 swagger 的定义规范
    rookie2luochao
        11
    rookie2luochao  
    OP
       201 天前
    @hailaz 还有一点细节是譬如 swaggo 这类 swagger 的代码级实现,生成的是 swagger2 的文档,然后用工具转的 openapi3 ,go 的转换工具转的细节处理的并不是很好,比如 formdata 上传文件的定义转的是有问题的
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2700 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 22ms · UTC 10:26 · PVG 18:26 · LAX 02:26 · JFK 05:26
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.