runapi是一款以接口為核心的開發(fā)測試工具，目前有客戶端版和在線精簡版，包含接口測試/項目協(xié)作等功能，功能上類似一個簡化版的postman。需要的朋友可下載試試！

和showdoc)相輔相成：showdoc以文檔為核心，側(cè)重文檔編寫和知識資料沉淀。而runapi則以接口為核心，包含接口測試、管理等一系列功能。同時它將自動生成文檔到showdoc，以及共用showdoc的團(tuán)隊管理機(jī)制，很好地實現(xiàn)接口的自動化和多人協(xié)作。相信使用 showdoc + runapi 這兩個工具組合，能夠極大地提高IT團(tuán)隊的效率。

基本簡介

如果你是使用runapi客戶端，則會自動跨域，可以請求本地和局域網(wǎng)的接口，不需要用戶額外操作。但如果你是使用在線精簡版則需要在API的服務(wù)器上設(shè)置允許跨域。在服務(wù)器返回API結(jié)果的時候，也順便返回三個允許跨域的httpheader，其結(jié)構(gòu)如下：
Access-Control-Allow-Origin:*Access-Control-Allow-Credentials:trueAccess-Control-Allow-Headers:Origin,X-Requested-With,Content-Type,Accept,Connection,User-Agent,Cookie
至于服務(wù)器如何操作httpheader，各語言有各語言的實現(xiàn)。php的實現(xiàn)如下所示：
//允許runapi.showdoc.cc發(fā)起的跨域請求header("Access-Control-Allow-Origin:*");header("Access-Control-Allow-Credentials:true");header("Access-Control-Allow-Headers:Origin,X-Requested-With,Content-Type,Accept,Connection,User-Agent,Cookie");
其他的語言的實現(xiàn)也同理。你可以上網(wǎng)搜索下如何更改httpheader的代碼，此處不再一一列舉。注意，項目上生產(chǎn)環(huán)境前，請把以上代碼注釋掉，以免暴露安全隱患。

安裝說明

下載軟件，雙擊運行即可自動安裝，需要注冊賬號

在線精簡版
在線精簡版和客戶端版差別很大，它只包含簡單的接口請求以及生成markdown代碼，只用作簡單調(diào)試，無法自動生成文檔到showdoc以及無法使用項目團(tuán)隊協(xié)作功能等。

軟件特色

開源文檔工具showdoc推出調(diào)試接口的客戶端（類似postman），支持windows和mac平臺。

開發(fā)者在調(diào)試接口的同時即可自動生成文檔到showdoc，簡單好用易上手。

此外，showdoc是用Vue+ElementUI寫的，而runapi主用React+AntDesign

RunApi特點

GET請求：點擊Params，輸入?yún)?shù)及value，可輸入多個，即時顯示在URL鏈接上

所以，GET請求的請求頭與請求參數(shù)如在接口文檔中無特別聲明時，可以不填。

GET響應(yīng)：右上角顯示響應(yīng)HTTP狀態(tài)碼、請求的耗時。

需特別注意的是注意區(qū)別HTTP狀態(tài)碼與響應(yīng)正文中的狀態(tài)碼，只有HTTP狀態(tài)碼是200時

才代表這個接口請求是正確的，這個是HTTP協(xié)議定義的，而響應(yīng)正文的狀態(tài)碼，是程序員自已定義的，可以是200，也可以定義為其它值，是為了讓接口使用者去區(qū)分正常數(shù)據(jù)與異常數(shù)據(jù)。

軟件功能

1、POST請求一：表單提交

設(shè)置了請求方法，請求URL，請求參數(shù)，但沒有設(shè)置請求頭。有一個要明確的點是，請求頭中的Content-Type與請求參數(shù)的格式之間是有關(guān)聯(lián)關(guān)系的。

Content-Type與請求參數(shù)的格式之間的關(guān)聯(lián)

當(dāng)選擇x-www-form-urlencoded的參數(shù)方式后，postman自動的幫我們設(shè)置了Content-Type，所以不需要我們?nèi)斯じ深A(yù)，這就是使用一款流行工具的好處，把一些基礎(chǔ)點都幫我們處理了。

2、POST請求二：json提交

當(dāng)我們選擇了JSON(application/json)時，postman同樣幫我們自動設(shè)置了Content-Type，可以自行的去查看Headers.

3、post請求三：xml提交

當(dāng)我們選擇了XML(text/xml)時，postman同樣幫我們自動設(shè)置了Content-Type，可以自行的去查看Headers.

4、post請求四：自行設(shè)置Content-Type

HTTP的POST請求的參數(shù)，都是放在請求正文中的，只是根據(jù)Content-Type來判斷請求正文的格式，那么我們同樣可以在表單提交時，選擇raw，然后自行設(shè)置Content-Type為application/x-www-form-urlencoded。

POST請求的參數(shù)

自行設(shè)置Content-Type

5、POST請求五：二進(jìn)制文件提交
二進(jìn)制文件提交

Body下，選擇binary，在這里你可以發(fā)送視頻、音頻、文本等文件。