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

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

基本簡(jiǎn)介

如果你是使用runapi客戶端，則會(huì)自動(dòng)跨域，可以請(qǐng)求本地和局域網(wǎng)的接口，不需要用戶額外操作。但如果你是使用在線精簡(jiǎn)版則需要在API的服務(wù)器上設(shè)置允許跨域。在服務(wù)器返回API結(jié)果的時(shí)候，也順便返回三個(gè)允許跨域的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，各語(yǔ)言有各語(yǔ)言的實(shí)現(xiàn)。php的實(shí)現(xiàn)如下所示：
//允許runapi.showdoc.cc發(fā)起的跨域請(qǐng)求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");
其他的語(yǔ)言的實(shí)現(xiàn)也同理。你可以上網(wǎng)搜索下如何更改httpheader的代碼，此處不再一一列舉。注意，項(xiàng)目上生產(chǎn)環(huán)境前，請(qǐng)把以上代碼注釋掉，以免暴露安全隱患。

安裝說(shuō)明

下載軟件，雙擊運(yùn)行即可自動(dòng)安裝，需要注冊(cè)賬號(hào)

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

軟件特色

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

開(kāi)發(fā)者在調(diào)試接口的同時(shí)即可自動(dòng)生成文檔到showdoc，簡(jiǎn)單好用易上手。

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

RunApi特點(diǎn)

GET請(qǐng)求：點(diǎn)擊Params，輸入?yún)?shù)及value，可輸入多個(gè)，即時(shí)顯示在URL鏈接上

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

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

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

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

軟件功能

1、POST請(qǐng)求一：表單提交

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

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

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

2、POST請(qǐng)求二：json提交

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

3、post請(qǐng)求三：xml提交

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

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

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

POST請(qǐng)求的參數(shù)

自行設(shè)置Content-Type

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

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