写了支持 go 后端框架的 swagger-ui 包,你会用它平替 swagger-ui 吗,不好用你拿屠龙刀砍我 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
请不要在回答技术问题时复制粘贴 AI 生成的内容
rookie2luochao

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

  •  
  •   rookie2luochao
    rookie-luochao 2024 年 5 月 7 日 2840 次点击
    这是一个创建于 717 天前的主题,其中的信息可能已经有所发展或是发生改变。

    不好用的话,请狠狠的提 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  
       2024 年 5 月 7 日
    我们早就内置了,不需要额外支持,哈哈哈
    https://goframe.org/pages/viewpage.action?pageId=40219890
        2
    ZackKing  
       2024 年 5 月 7 日
    @hailaz GF 大法好, 就是特殊需求不好改
    rookie2luochao
        3
    rookie2luochao  
    OP
       2024 年 5 月 7 日
    @hailaz 可是 redocly 都无法测试接口,阅读体验也没有我写的这个好,不信你可以体验一下,你们当真有为前端和测试同学提前测试接口考虑过吗
    rookie2luochao
        4
    rookie2luochao  
    OP
       2024 年 5 月 7 日
    @hailaz 我看你的框架下面有人吐槽:新版本的 swagger 最好支持在线发送请求,这样方便前端开发人员测试接口
    rookie2luochao
        5
    rookie2luochao  
    OP
       2024 年 5 月 7 日
    @hailaz 说明群众的眼睛是雪亮的,redocly 为什么不加测试接口的功能,确实无法理解
    hailaz
        6
    hailaz  
       2024 年 5 月 7 日
    @rookie2luochao 额,支持自定义 ui 的
    rookie2luochao
        7
    rookie2luochao  
    OP
       2024 年 5 月 7 日
    @hailaz 支持自定义接口请求功能吗?那为啥我看接入 redocly 的都没有自定义过呢,这就尴尬了
    rookie2luochao
        8
    rookie2luochao  
    OP
       2024 年 5 月 7 日
    @hailaz 我看你们管理员的回复都是:gf 2.0.1 之后,文档 UI 使用的 redoc, redoc 没有 try it console 。如果想使用旧版的 swaggerUI ,可以使用 gf v2.0.0-rc3 版本
    hailaz
        9
    hailaz  
       2024 年 5 月 7 日
    @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
       2024 年 5 月 7 日
    @hailaz 是你理解的必须带 tag ,我接触过的 swagger.json 定义都是有 tag 的,这让我误以为 tag 字段是必带的,但最重要的原因是我并没有去仔细阅读 swagger 的定义规范
    rookie2luochao
        11
    rookie2luochao  
    OP
       2024 年 5 月 7 日
    @hailaz 还有一点细节是譬如 swaggo 这类 swagger 的代码级实现,生成的是 swagger2 的文档,然后用工具转的 openapi3 ,go 的转换工具转的细节处理的并不是很好,比如 formdata 上传文件的定义转的是有问题的
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     2929 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 31ms UTC 11:10 PVG 19:10 LAX 04:10 JFK 07:10
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86