有没有好的 api 文档管理系统? - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
Sign Up Now
For Existing Member  Sign In
请不要在回答技术问题时复制粘贴 AI 生成的内容
subpo

有没有好的 api 文档管理系统?

  •  
  •   subpo Dec 18, 2014 6785 views
    This topic created in 4159 days ago, the information mentioned may be changed or developed.
    需求如下:
    1.可部署成web页面
    2.可用markdown书写api文档
    3.有后台,可以直接在网站上添加api
    24 replies    2015-09-07 12:39:55 +08:00
    Livid
        1
    Livid  
    MOD
    PRO
       Dec 18, 2014   2
    https://dash.readme.io/

    可以做出很像 Stripe 文档网站的 API 文档站。
    aveline
        2
    aveline  
       Dec 18, 2014   3
    xw
        3
    xw  
       Dec 18, 2014
    关注
    subpo
        4
    subpo  
    OP
       Dec 18, 2014
    我希望是面向内部使用的,多项目的api文档,而不是一个项目介绍文档
    subpo
        5
    subpo  
    OP
       Dec 18, 2014
    @aveline
    @Livid
    我希望是面向内部使用的,多项目的api文档,而不是一个项目介绍文档,最好是能部署到自己服务器上的开源的项目(毕竟不想让别人看到私有的api文档),要求好像挺苛刻的,有吗...
    harryert
        6
    harryert  
       Dec 18, 2014
    mark,我也想知道。。。
    lululau
        7
    lululau  
       Dec 18, 2014
    Github Enterprise
    subpo
        8
    subpo  
    OP
       Dec 18, 2014
    @aveline http://apidoc.io/ 很符合我的需求,要是这个网站能支持只有固定的登录用户才能看到文档就好了...
    efi
        9
    efi  
       Dec 18, 2014 via Android
    Markdown写api?如果你写过就知道与Markdown语法搏斗的痛苦。试试列表和代码混写。
    youyongsong
        10
    youyongsong  
       Dec 18, 2014
    How do you document your APIs? http://www.infoq.com/research/api-documentation
    个人觉得Swagger很不错,还可以直接集成到Django,Flask等框架里,有点像KSS。
    janxin
        11
    janxin  
       Dec 18, 2014
    同意 @efi 的说法,markdown排版某些时候还是满痛苦的
    humiaozuzu
        12
    humiaozuzu  
       Dec 18, 2014
    用过好多,发现还是 confluence 好用。。。
    yylyyl
        13
    yylyyl  
       Dec 19, 2014 via iPhone
    Confluence +1
    JamesRuan
        14
    JamesRuan  
       Dec 19, 2014 via Android
    自己撸了一个,没后台,没多项目,不支持markdown,但是支持一个比markdown更适合排版的自己发明的语言。
    egen
        15
    egen  
       Dec 19, 2014
    mark一下,之前一直用 markdown 写文档,基本可以满足需求,不过觉得写的重复性的东西有点太多,看看有没有更好的方案
    XinRen
        16
    XinRen  
       Dec 19, 2014
    关注
    subpo
        17
    subpo  
    OP
       Dec 19, 2014
    你们只收藏不贡献!
    markdown不是必须,只要有个足够好用的编辑器就可以
    tanran
        18
    tanran  
       Dec 19, 2014
    apidoc很好用
    KMHook
        19
    KMHook  
       Dec 19, 2014
    mark,学习
    kimmykuang
        20
    kimmykuang  
       Dec 19, 2014
    mark下,回去细细观之
    lguan
        21
    lguan  
       Dec 20, 2014
    我用redmine写过api文档,就是textile,用github的写过,就是markdown,最后发现,还是confluence的最好用,markdown我很喜欢用,但是有些东西不好做,比如,表格
    zealic
        22
    zealic  
       Dec 20, 2014
    https://github.com/gollum/gollum

    with:
    GitHub Flavored Markdown
    magicrolan
        23
    magicrolan  
       Mar 19, 2015
    以后看看吧
    现在我也是迷茫
    qw0258
        24
    qw0258  
       Sep 7, 2015
    mark ,学习
    About     Help     Advertise     Blog     API     FAQ     Solana     3233 Online   Highest 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 97ms UTC 14:17 PVG 22:17 LAX 07:17 JFK 10:17
    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