接口測試是什麼&接口測試文檔規範

如下內容選自《大話軟件測試-性能、自動化、安全及團隊管理》

接口測試是什麼？接口測試怎麼作？這樣的問題幾乎天天都會被問到幾十次，可見不少朋友對於接口測試並非十分了解，而接口測試又是如今互聯網產品測試中的重中之重，因此學習並掌握它是必須的。本章咱們力爭通俗化的揭開接口測試的面紗，讓你們看到它的本質。

特別須要指出，在本書的其餘章節也講解了接口測試的相關內容，好比LoadRunner、Jmeter、SoapUI章節等，因此想掌握接口測試最好通讀本書。

9.1接口測試是什麼

接口有時候咱們也會叫作API，不管是哪一種叫法本質上都是接口，就好像叫你的全名和小名，本質上都是你這我的。對於接口測試是什麼咱們給你們進行兩種解釋。

不通俗的解釋：發送一個請求到服務器端，服務器端處理完畢以後返回一個響應，咱們對響應進行驗證是否符合預期結果。至於服務器端是怎麼處理這個請求的咱們並不關心。咱們只關心輸入和輸出便可，如圖9.1。

 

圖9.1 請求和響應

通俗的解釋：接口和電腦的USB同樣，你不須要關心內部是怎麼實現的，你只須要知道這個接口在哪，怎麼用，插上能幹什麼便可。好比：我要驗證這個USB能不能用，那麼插入鼠標，鼠標能夠正常工做說明USB能夠用，咱們並不關心USB的實現邏輯。同理，咱們的接口測試也是同樣的。

9.2接口文檔規範

接口測試進行的前提是必定要有接口文檔，咱們要經過文檔獲取接口的說明、請求參數、響應參數以及一些依賴關係。通常公司都會有接口文檔的，畢竟開發人員也要作接口的維護，若是沒有文檔之後維護起來是比較麻煩的。固然有的公司確實沒有接口文檔，那對於測試工程師來講只能本身經過抓包來分析請求和響應了。

規範的接口文檔無論是對於開發仍是測試都是有百利而無一害的，通常都包括接口名、接口描述、接口地址、請求方式、請求參數和格式、響應參數和格式等，具體示例以下：

l 接口名：mLogin

l 接口描述：移動端登陸接口

l 接口地址：http://xxx/mLogin

l 請求方式：POST

l 支持格式：JSON

l 請求參數：

username 必填 類型string 用戶名

pwd 必填 類型string 密碼

l 響應參數：

errorCode 狀態碼 0表示成功；1表示失敗

username 用戶名

這裏只是舉了個例子，實際須要哪些描述仍是要根據實際狀況作調整的。

對於接口文檔的維護也是一件讓人頭疼的事情，尤爲是接口數量比較多的時候。我見過的維護方法有以下幾種：

l Word或者Excel維護。不推薦，量小的時候還能夠，量大的時候太困難。

l Wiki維護。推薦，相對來講比較好管理。

l 接口文檔維護工具。好比：apizza、apiview、小幺雞等，如圖9.2。

 

圖9.2 接口文檔維護工具