這幾天要寫(xiě)一個(gè)接口API文檔，經(jīng)理給我發(fā)過(guò)來(lái)一個(gè)，說(shuō)要弄一個(gè)這樣的接口文檔，我一看，這可麻煩呀，有大綱有詳細(xì)，我以為要用div+css去一個(gè)頁(yè)面一個(gè)頁(yè)面做呢，這工作量可不小，網(wǎng)站一搜索，竟然有可以直接生成api接口文檔的網(wǎng)站，我又孤陋寡聞了，通過(guò)這幾天的使用比較，我選定了showodc。

SHOWDOC

我本來(lái)用的apiary.io，全體也不錯(cuò)，而且是oralce收購(gòu)的，發(fā)展應(yīng)該可以，但是國(guó)外的服務(wù)器國(guó)內(nèi)訪(fǎng)問(wèn)實(shí)在。。。。后來(lái)說(shuō)在國(guó)內(nèi)找一下，很幸運(yùn)我發(fā)現(xiàn)了showdoc。

showdoc網(wǎng)站打開(kāi)看著不起眼，但里面的內(nèi)容相當(dāng)?shù)膹?qiáng)大，重點(diǎn)說(shuō)下特點(diǎn)

1：支持markdown語(yǔ)法(所有的api接口寫(xiě)作現(xiàn)在都支持這個(gè)吧，因?yàn)樗F(xiàn)在太方便了)

2：支持多用戶(hù)協(xié)作，你可以在項(xiàng)目下面隨意添加多個(gè)用戶(hù)一起完成api文檔的寫(xiě)作。

3：可以分享并導(dǎo)出項(xiàng)目，生成需要的文檔格式如doc，可以離線(xiàn)瀏覽

4：支持響應(yīng)式，手機(jī)電腦同樣精彩

5：支持項(xiàng)目轉(zhuǎn)讓

6：支持模版插入

7：支持歷史版本，你可以把操作恢復(fù)到以前的版本。

8：showdoc完全開(kāi)源

9：可以部署到自己的服務(wù)器

10：如果在線(xiàn)使用，可以設(shè)置自己的個(gè)性域名，也可以對(duì)文檔進(jìn)行加密，瀏覽者需要密碼才能訪(fǎng)問(wèn)

11：可以通過(guò)一個(gè)在線(xiàn)測(cè)試api的工具，直接生成markdown，你幾乎不用寫(xiě)代碼就能過(guò)所有的參數(shù)自動(dòng)生成

看一些頁(yè)面：

如果你正在找快點(diǎn)試試吧

www.showdoc.cc

總結(jié)

以上是生活随笔為你收集整理的api服务器开发语言,【API编写】介绍一个国内强大的API接口文档写作网站showdoc - 最好的编程语言 - 博客园...的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。