11.1 接口
11.1.1 接口概述
定義:接口就是API(Application Programming Interface寂殉,應(yīng)用程序接口)缤灵,是一個軟件或服務(wù)對外提供的接口租副,別人只要調(diào)用這接口悼做,而內(nèi)部如何實現(xiàn)皆串,不需要關(guā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é)果都是需要不停搬運的“貨物”——數(shù)據(jù)阴挣,則負責(zé)調(diào)配分配打包的中轉(zhuǎn)站就是API,快遞小哥直接從中轉(zhuǎn)站取貨就好纺腊。
作用:對于軟件提供商來說畔咧,留出API,讓別的應(yīng)用程序來調(diào)用揖膜,軟件才能發(fā)揮最大的價值誓沸,才能更有生命力。(同時別人也看不見代碼壹粟,不傷害商業(yè)機密拜隧。)
對于應(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ù)進行了加密和簽名逛漫,以保證數(shù)據(jù)傳輸?shù)陌踩院诘汀N覀兤匠4蜷_兩頁的時候會看到網(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)容標題捆蜀,版本號,公司名稱幔嫂,文檔產(chǎn)生
日期辆它。(錯誤地方在于,文檔的標題要和頁眉中的標題一致)
11.2.2 修訂歷史
表格形式較好些履恩。包括:
版本锰茉,修訂說明,修訂日期切心,修訂人飒筑,審核時間,審核人昙衅。
11.2.3 接口信息
接口調(diào)用方式扬霜,是post方式還是get方式,接口地址而涉,別人需要線上的哪個地址就寫哪個著瓶。(自己提前測試好線上的這個接口,是否有其他問題啼县,千萬別犯低級的錯誤材原,尤其是某個字母寫錯)
11.2.4 功能描述
一定要清晰的描述接口功能。(不要遺漏一些細節(jié)季眷,比如接口獲取的信息不包括哪些余蟹,哪些要寫明白)
11.2.5 接口參數(shù)說明
每個參數(shù)都要和實際中調(diào)用的一樣,包括大小寫子刮;參數(shù)的含義言簡意賅的說明威酒;格式是string 還是int 還是long等格式(例如參數(shù)為@RequestParam("appKey") StringappKey, @RequestParam("randomId") Integer randomId)窑睁;說明部分,說明參數(shù)值是需要哪個公司提供葵孤,并詳細說明參數(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è)性能測試工具穆刻,用來做接口測試置尔,很好很強大 ,但是配置比較麻煩氢伟。
SoapUI:開源測試工具榜轿,通過soap/http來檢查、調(diào)用朵锣、實現(xiàn)Web Service的功能/負載/符合性測試谬盐;該工具既可作為一個單獨的接口測試工具使用,也可利用插件集成到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 擴展插件
postman:谷歌瀏覽器的擴展工具,主要用來做接口測試雪隧,谷歌商店中選中安裝西轩,界面同poster差別不大,界面簡潔脑沿。
13.6 接口測試應(yīng)該測什么
13.6.1 單一接口
單一接口功能的測試主要測試返回的數(shù)據(jù)結(jié)構(gòu)是否和接口文檔給出的一致藕畔,接口的正常功能是否完成,接口的參數(shù)檢查測試庄拇,接口的異常測試注服。
13.6.2 組合接口
定義:組合接口測試主要是通過組合多個單一接口,來測試一個業(yè)務(wù)場景
案例:測試購物網(wǎng)站的一個下單的功能措近,那么因為在下單之前還有一些流程溶弟,所以要測試一個場景。
測試:搜索商品 --> 選中商品 --> 添加進購物車 --> 提交訂單 -->支付
(提交訂單時還涉及到地址的選取等)
注:涉及到如果使用從cookie或者session在本例中的區(qū)別:如果使用cookie加入購物車瞭郑,那么換一臺電腦購物車里的商品就不存在了辜御,但如果使用的是session,購物車里面的東西就一直存在屈张,即:cookie是本機作用的擒权,session不止于本機作用。
13.6.3 結(jié)構(gòu)檢查
(1)檢查返回值的結(jié)構(gòu)是否正確阁谆,如是json類型還是xml類型的數(shù)據(jù)
(2)字段名稱是否正確等
XML和JSON都使用結(jié)構(gòu)化方法來標記數(shù)據(jù)
13.7 接口測試內(nèi)容
13.7.1 功能邏輯
通過查數(shù)據(jù)庫或緩存等驗證數(shù)據(jù)是否處理正確碳抄。
通過其他輔助途徑進行驗證
13.7.2 異常測試
接口測試中主要測試接口正常邏輯,但僅邏輯測試不能保證數(shù)據(jù)的安全及程序接口在異常情況下的邏輯處理的正確性场绿。
13.7.3 路徑測試
當(dāng)被測接口的實現(xiàn)方法中剖效,判斷邏輯復(fù)雜分支多,且判斷中又調(diào)用了其他的接口裳凸,此時必須要進行路徑覆蓋測試贱鄙。
13.7.4 其他異常場景
研發(fā)的項目,有些項目是底層使用的系統(tǒng)姨谷,根據(jù)項目特點逗宁,可能會存在特殊的異常場景。
例如: 支付的異步操作梦湘,支付消息重試等
11.8 測試案例
11.8.1 get請求
11.8.2 post請求
13.9 接口測試用例模板