请问大家有没有好用的 json 或者 api 文档管理工具 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
请不要在回答技术问题时复制粘贴 AI 生成的内容
unt
V2EX    程序员

请问大家有没有好用的 json 或者 api 文档管理工具

  •   unt 2022-12-26 21:30:13 +08:00 2974 次点击
    这是一个创建于 1035 天前的主题,其中的信息可能已经有所发展或是发生改变。

    需求:

    1. 一定要清晰,清晰,清晰。每个字段的含义可以写详细注释,json 结构不要以表格的形式展示,要以 json 文档的形式展示;
    2. 是“文档”管理,不是调试,不需要接口调试的功能;
    3. 方便信息共享,最好是像 rap2 那样支持自部署的 web 端,或者客户端工具也可以;
    18 条回复    2022-12-29 20:20:59 +08:00
    xuanbg
        1
    xuanbg  
       2022-12-26 21:42:08 +08:00
    手写,其实一点都不麻烦。也就是模版填空加上复制 /粘贴 /修改一点点内容。
    needpp
        2
    needpp  
       2022-12-26 21:49:55 +08:00
    查看右边的广告?
    wu67
        3
    wu67  
       2022-12-26 21:54:40 +08:00
    我觉得 gitlab 的 wiki 就很好, 直接用 markdown 写, object 型数据你爱怎么写都行, 复杂数据结构还能在下面写连接跳转对应结构的 wiki, 还有历史记录
    unt
        4
    unt  
    OP
       2022-12-26 22:09:53 +08:00
    @xuanbg #1 主要是不美观,查看起来也不是很方便
    unt
        5
    unt  
    OP
       2022-12-26 22:10:04 +08:00
    @wu67 #3 我去看看
    xuanbg
        6
    xuanbg  
       2022-12-27 03:12:34 +08:00
    @wu67 咱们想的完全一样。手写 markdown 才是程序员该干的事。
    inrmsYu
        7
    inrmsYu  
       2022-12-27 08:20:21 +08:00
    apipost ?
    IMCDR2
        8
    IMCDR2  
       2022-12-27 08:41:21 +08:00
    yapi?
    unt
        9
    unt  
    OP
       2022-12-27 08:52:21 +08:00
    @iamacodertoo #8 用过的,不行,文档功能不太好

    @xuanbg #6 md 的话注释功能不行吧,我要给每个字段写注释,然后需要能够复制整个 json, 能实现吗
    balabalaguguji
        10
    balabalaguguji  
       2022-12-27 09:31:03 +08:00
    nekoneko
        11
    nekoneko  
       2022-12-27 17:08:14 +08:00
    postman 自带
    garfield12
        12
    garfield12  
       2022-12-27 17:31:54 +08:00
    apifox
    star7th
        13
    star7th  
       2022-12-27 23:00:16 +08:00
    shanyue
        14
    shanyue  
       2022-12-28 11:32:51 +08:00
    unt
        15
    unt  
    OP
       2022-12-28 13:55:39 +08:00
    @garfield12 #12
    @shanyue #14 刚出来的时候就用过,ui 肯定是属于中上层没得讲,但是必须登录账号,不能自部署(要钱)加离线,都不用(网络用语,非冒犯)
    unt
        16
    unt  
    OP
       2022-12-28 13:56:27 +08:00
    @star7th #13 嗯,这些都有记录在自己的小本本上,之前用过,我再试试
    hellojukay
        17
    hellojukay  
       2022-12-28 14:20:53 +08:00
    openapi
    8bryo4p5qn758Dmv
        18
    8bryo4p5qn758Dmv  
       2022-12-29 20:20:59 +08:00
    https://gotcha.rest 支持设计 API ,编辑和复用数据模型,导出到 Swagger 或 OpenAPI 格式。你需要的“每个字段的含义可以写详细注释”完全支持,并且可以编辑约束条件,默认值示例值这些
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     932 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 26ms UTC 18:34 PVG 02:34 LAX 11:34 JFK 14:34
    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