第十一單元 接口測試以及用例編寫
11.1 接口
11.1.1 接口概述
定義：接口就是API（Application Programming Interface，應(yīng)用程序接口）芭逝，是一個軟件或服務(wù)對外提供的接口揪荣，別人只要調(diào)用這接口隅茎，而內(nèi)部如何實現(xiàn)甩栈，不需要關(guān)心。你只要按照要求進(jìn)行接口調(diào)用即可营袜。
外部系統(tǒng)與系統(tǒng)之間以及內(nèi)部各子系統(tǒng)之間的交互點。包括外部接口关霸、內(nèi)部接口传黄。
舉例：
假設(shè)物流中“貨物”是數(shù)據(jù)，存放貨物的“總倉庫”是數(shù)據(jù)庫谒拴，“店鋪”是我們的網(wǎng)站尝江、App涉波。頁面上顯示的內(nèi)容英上、數(shù)字，以及用戶的操作請求和結(jié)果都是需要不停搬運(yùn)的“貨物”——數(shù)據(jù)啤覆，則負(fù)責(zé)調(diào)配分配打包的中轉(zhuǎn)站就是API苍日，快遞小哥直接從中轉(zhuǎn)站取貨就好。
作用：對于軟件提供商來說窗声，留出API相恃，讓別的應(yīng)用程序來調(diào)用，軟件才能發(fā)揮最大的價值笨觅，才能更有生命力拦耐。（同時別人也看不見代碼，不傷害商業(yè)機(jī)密见剩。）
對于應(yīng)用開發(fā)者來說杀糯，有了開放的API，就可以直接調(diào)用多家公司做好的功能來做自己的應(yīng)用苍苞，不需要所有的事情都自己操刀固翰，節(jié)省精力。
11.1.2 接口的表現(xiàn)形式
客戶端要先操作服務(wù)端資源羹呵，首先要找到服務(wù)端提供的接口骂际，然后才能向服務(wù)端發(fā)送資源請求，那么何為服務(wù)端接口呢冈欢？其實就是一個地址（URL）歉铝，比如：
http://www.qubaobei.com/ios/cf/dish_list.php?stage_id=1&limit=20&page=1
1615302590(1).png
采用的協(xié)議(http:)：一般來講網(wǎng)址中第一個“:”前面的就是該網(wǎng)址所采用的協(xié)議。這里的HTTP就是個協(xié)議 凑耻。HTTPS是HTTP的安全版本太示，HTTPS在HTTP的基礎(chǔ)對傳輸?shù)臄?shù)據(jù)進(jìn)行了加密和簽名，以保證數(shù)據(jù)傳輸?shù)陌踩匀啊Ｎ覀兤匠４蜷_兩頁的時候會看到網(wǎng)址前面都有一個HTTP或HTTPS先匪，這就是告訴你，你在向服務(wù)器發(fā)送此請求的過程中要遵循的協(xié)議是HTTP或HTTPS (也就是規(guī)則)弃衍。
服務(wù)器地址(//www.qubaobei.com)：以雙斜杠“//”開頭呀非，后面跟的就是這個服務(wù)器的地址，專業(yè)術(shù)語叫域名。
請求資源路徑(/ios/cf/dish_list.php) ：表示你要請求的資源在該服務(wù)器下/ios/cf/dish_list.php的路徑下岸裙。
參數(shù)（?stage_id=1&limit=20&page=1）：參數(shù)可以找到具體內(nèi)容猖败，和路徑之間使用“?”隔開，參數(shù)之間使用“&”隔開降允。參數(shù)是以鍵值對的形式表現(xiàn)出來的恩闻。
把此URLhttp://www.qubaobei.com/ios/cf/dish_list.php?stage_id=1&limit=20&page=1稱為食品模塊個接口， 也稱為接口地址剧董。
11.2 接口文檔
接口文檔展示
11.2.1 封皮
封面最好是本公司規(guī)定的封面幢尚，有l(wèi)ogo，內(nèi)容標(biāo)題翅楼，版本號尉剩，公司名稱，文檔產(chǎn)生
日期毅臊。（錯誤地方在于理茎，文檔的標(biāo)題要和頁眉中的標(biāo)題一致）
11.2.2 修訂歷史
表格形式較好些。包括：
版本管嬉，修訂說明皂林，修訂日期，修訂人蚯撩，審核時間础倍，審核人。
11.2.3 接口信息
接口調(diào)用方式求厕，是post方式還是get方式著隆，接口地址，別人需要線上的哪個地址就寫哪個呀癣。（自己提前測試好線上的這個接口美浦，是否有其他問題，千萬別犯低級的錯誤项栏，尤其是某個字母寫錯）
11.2.4 功能描述
一定要清晰的描述接口功能浦辨。（不要遺漏一些細(xì)節(jié)，比如接口獲取的信息不包括哪些沼沈，哪些要寫明白）
11.2.5 接口參數(shù)說明
每個參數(shù)都要和實際中調(diào)用的一樣流酬，包括大小寫；參數(shù)的含義言簡意賅的說明列另；格式是string 還是int 還是long等格式（例如參數(shù)為@RequestParam("appKey") StringappKey, @RequestParam("randomId") Integer randomId）芽腾；說明部分，說明參數(shù)值是需要哪個公司提供页衙，并詳細(xì)說明參數(shù)怎么生成的摊滔，例如時間戳阴绢，是哪個時間段的；參數(shù)是否必填艰躺，一些參數(shù)是必須要有的呻袭，有些是可選參數(shù)，一定要注意寫清晰腺兴。
11.2.6 返回值說明
1左电、有一個模板返回值，并說明每個返回參數(shù)的意義页响。
2篓足、提供一個真實的調(diào)用接口，真實的返回值拘泞。
注：現(xiàn)實工作中纷纫，對接口有疑問要及時跟同事交流。
11.3 接口測試的概念
11.3.1 概念
測試系統(tǒng)組件間接口的一種測試陪腌。接口測試主要用于檢測外部系統(tǒng)與系統(tǒng)之間以及內(nèi)部各個子系統(tǒng)之間的交互點。
11.3.2 接口測試本質(zhì)
實質(zhì)就是數(shù)據(jù)的傳輸和接受烟瞧，傳輸?shù)氖墙涌诘刂分械膮?shù)诗鸭，接受的是文本字符串，然后對比文本字符串是否正確参滴。
11.4 接口測試的目的和原理
11.4.1 目的
測試接口的正確性和穩(wěn)定性强岸。
11.4.2 原理
接口測試的原理是通過測試程序模擬客戶端向服務(wù)器發(fā)送請求報文，服務(wù)器接收請求報文后對相應(yīng)的報文做出處理然后再把應(yīng)答報文發(fā)送給客戶端砾赔，客戶端接收應(yīng)答報文這一個過程蝌箍。
11.5 常用接口測試工具
11.5.1 典型商業(yè)工具：
LoadRunner（LR）：一款商業(yè)性能測試工具，用來做接口測試暴心，很好很強(qiáng)大 妓盲，但是配置比較麻煩。
SoapUI：開源測試工具专普，通過soap/http來檢查悯衬、調(diào)用、實現(xiàn)Web Service的功能/負(fù)載/符合性測試檀夹；該工具既可作為一個單獨的接口測試工具使用筋粗，也可利用插件集成到Eclipse，maven2.X炸渡，Netbeans 和intellij中使用娜亿。 了解就可以了，基本已經(jīng)不用了蚌堵。
11.5.2 典型開源工具
Jmeter ：一款開源的接口測試工具买决，操作簡單，方便，既有jdbc request操作數(shù)據(jù)庫數(shù)據(jù)策州，也有http request和soap request應(yīng)對測試
13.5.3 擴(kuò)展插件
postman：谷歌瀏覽器的擴(kuò)展工具瘸味，主要用來做接口測試，谷歌商店中選中安裝够挂，界面同poster差別不大旁仿，界面簡潔。
13.6 接口測試應(yīng)該測什么
13.6.1 單一接口
單一接口功能的測試主要測試返回的數(shù)據(jù)結(jié)構(gòu)是否和接口文檔給出的一致孽糖，接口的正常功能是否完成枯冈，接口的參數(shù)檢查測試，接口的異常測試办悟。
13.6.2 組合接口
定義：組合接口測試主要是通過組合多個單一接口尘奏，來測試一個業(yè)務(wù)場景
案例：測試購物網(wǎng)站的一個下單的功能，那么因為在下單之前還有一些流程病蛉，所以要測試一個場景炫加。
測試：搜索商品 --> 選中商品 --> 添加進(jìn)購物車 --> 提交訂單 -->支付
（提交訂單時還涉及到地址的選取等）
注：涉及到如果使用從cookie或者session在本例中的區(qū)別：如果使用cookie加入購物車，那么換一臺電腦購物車?yán)锏纳唐肪筒淮嬖诹似倘唬绻褂玫氖莝ession俗孝，購物車?yán)锩娴臇|西就一直存在，即：cookie是本機(jī)作用的魄健，session不止于本機(jī)作用赋铝。
13.6.3 結(jié)構(gòu)檢查
（1）檢查返回值的結(jié)構(gòu)是否正確，如是json類型還是xml類型的數(shù)據(jù)
（2）字段名稱是否正確等
XML和JSON都使用結(jié)構(gòu)化方法來標(biāo)記數(shù)據(jù)
13.7 接口測試內(nèi)容
13.7.1 功能邏輯
通過查數(shù)據(jù)庫或緩存等驗證數(shù)據(jù)是否處理正確沽瘦。
通過其他輔助途徑進(jìn)行驗證
13.7.2 異常測試
接口測試中主要測試接口正常邏輯革骨，但僅邏輯測試不能保證數(shù)據(jù)的安全及程序接口在異常情況下的邏輯處理的正確性。
13.7.3 路徑測試
當(dāng)被測接口的實現(xiàn)方法中析恋，判斷邏輯復(fù)雜分支多良哲，且判斷中又調(diào)用了其他的接口，此時必須要進(jìn)行路徑覆蓋測試绿满。
13.7.4 其他異常場景
研發(fā)的項目臂外，有些項目是底層使用的系統(tǒng)，根據(jù)項目特點喇颁，可能會存在特殊的異常場景漏健。
例如： 支付的異步操作，支付消息重試等
11.8 測試案例
11.8.1 get請求
11.8.2 post請求
13.9 接口測試用例模板
