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請求