一个想法:通过中间层代理来解析 API 输入/输出,自动生成 swagger 文档 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
这是一个专门讨论 idea 的地方。

每个人的时间,资源是有限的,有的时候你或许能够想到很多 idea,但是由于现实的限制,却并不是所有的 idea 都能够成为现实。

那这个时候,不妨可以把那些 idea 分享出来,启发别人。
page470075640
V2EX    奇思妙想

一个想法:通过中间层代理来解析 API 输入/输出,自动生成 swagger 文档

  •  1
     
  •   page470075640 2022-08-22 15:57:22 +08:00 2468 次点击
    这是一个创建于 1153 天前的主题,其中的信息可能已经有所发展或是发生改变。
    代理目标是 API test code ,想知道有现成的这类工具吗?如果没有我就打算尝试一下。。。
    10 条回复    2022-08-23 19:00:23 +08:00
    jstony
        1
    jstony  
       2022-08-22 17:29:02 +08:00
    感觉意义不大,一般不是应该文档先行吗?
    luvroot
        2
    luvroot  
       2022-08-22 17:35:27 +08:00
    grpc reflect 现在就支持
    xaplux
        3
    xaplux  
       2022-08-22 17:41:51 +08:00
    接口描述,参数描述等获取不到吧,感觉这个还是比较重要的
    page470075640
        4
    page470075640  
    OP
       2022-08-22 18:16:16 +08:00
    @jstony 不同的开发方式吧。。。我这边都是写完测试代码后才开始写文档的

    @luvroot 能贴一下项目链接吗?

    @xaplux 参数描述确实是个问题,目前的想法是通过变量的语义和错误信息来说明这个问题。
    luvroot
        5
    luvroot  
       2022-08-22 18:42:25 +08:00
    wdwwtzy
        6
    wdwwtzy  
       2022-08-22 18:44:42 +08:00
    不太明白,写注释的时候,不就是写好了 swagger 文档吗?是其他语言不行吗?.net 就是注释就是 swagger 文档
    luvroot
        7
    luvroot  
       2022-08-22 18:50:24 +08:00
    一般都是通过写注释写好了 由工具生成 swagger json 。
    还有一种完全不写注释,比如 grpc 的这种通过 reflect 找到接口名字和参数,只提供接口名和参数展示
    page470075640
        8
    page470075640  
    OP
       2022-08-22 19:42:48 +08:00 via iPhone
    结贴:通过注释或者 grpc 能自动生成 swagger ,谢谢各位答疑解惑
    kkeep
        9
    kkeep  
       2022-08-22 20:07:12 +08:00 via Android
    已经有了
    ternice
        10
    ternice  
       2022-08-23 19:00:23 +08:00
    swagger 感觉只适合 个人开发或者独立开发
    实际项目 接口设计和接口实现就不是一个人,都是先有文档才有接口
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     2677 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 23ms UTC 14:19 PVG 22:19 LAX 07:19 JFK 10:19
    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