介面測試Postman使用方法、傳送Get、post請求
什麼是介面?
https://gqrfgy.yuque.com/docs/share/c54f5e2e-67c1-43e0-9b4f-62abb772331a?# 《介面測試的原理》
https://gqrfgy.yuque.com/docs/share/105d4a34-421d-4a44-a508-abd7ea018e80?# 《介面測試的概念和介面組成》
https://gqrfgy.yuque.com/docs/share/d2a000b0-94de-4df1-8edd-b4db21e3c857?# 《為什麼學習介面測試》
postman介紹
介面測試工具很多。 Postman,Jmeter,soupui等
下載
https://www.postman.com/downloads/
介面文件
https://work.weixin.qq.com/api/doc/90000/90135/90664
請求方式: GET(HTTPS)
請求地址: https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET
注:此處標註大寫的單詞ID和SECRET,為需要替換的變數,根據實際獲取值更新。其它介面也採用相同的標註,不再說明。
引數說明:
引數 |
必須 |
說明 |
corpid |
是 |
企業ID,獲取方式參考:術語說明-corpid |
corpsecret |
是 |
應用的憑證金鑰,獲取方式參考: |
許可權說明:
每個應用有獨立的secret,獲取到的access_token只能本應用使用,所以每個應用的access_token應該分開來獲取
返回結果:
{ "errcode": 0, "errmsg": "ok", "access_token": "accesstoken000001", "expires_in": 7200}
引數說明:
引數 |
說明 |
errcode |
出錯返回碼,為0表示成功,非0表示呼叫失敗 |
errmsg |
返回碼提示語 |
access_token |
獲取到的憑證,最長為512位元組 |
expires_in |
憑證的有效時間(秒) |
注意事項:
開發者需要快取access_token,用於後續介面的呼叫(注意:不能頻繁呼叫gettoken介面,否則會受到頻率攔截)。當access_token失效或過期時,需要重新獲取。
access_token的有效期通過返回的expires_in來傳達,正常情況下為7200秒(2小時),有效期內重複獲取返回相同結果,過期後獲取會返回新的access_token。
由於企業微信每個應用的access_token是彼此獨立的,所以進行快取時需要區分應用來進行儲存。
access_token至少保留512位元組的儲存空間。
企業微信可能會出於運營需要,提前使access_token失效,開發者應實現access_token失效時重新獲取的邏輯。
企業id |
ww88fc20d87e4cdfa1 |
會議室管理金鑰 |
8kZYaPdkie4nuh3itIwhgUKpam5Xyoq5hU4uivaswp4 |
postman 傳送第一個GET請求
- 開啟Postman,新建一個請求。
- 根據文件上說明,選擇對應的【請求方式】,【請求地址】
根據文件上的說明,複製進來。
請求方式: GET(HTTPS)
請求地址: https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET
- 根據文件說明,將ID,SECRET換成具體的值。(值一般是由開發提供)
ID |
ww88fc20d87e4cdfa1 |
SECRET |
8kZYaPdkie4nuh3itIwhgUKpam5Xyoq5hU4uivaswp4 |
- 點選【Send】
儲存第一個請求
測試完成之後可以將請求儲存下來方便下次使用。
可以使用快捷鍵 CTRL+S 進行儲存。 儲存的時候會提示輸入請求名,儲存路徑。
儲存完成之後
可以看到
Postman7.x 版本儲存
- 點選【Save】
- 輸入請求名,建立集合
建立集合
可以看到儲存的記錄。
Postman傳送第一個Post請求
根據文件
- 新建請求。根據介面文件 輸入請求方式,請求路徑,請求body資料。
請求方式:POST(HTTPS)
請求地址:https://qyapi.weixin.qq.com/cgi-bin/oa/meetingroom/add?access_token=ACCESS_TOKEN
注意: 請求資料
{
"name":"18F-會議室",
"capacity":10,
"city":"深圳",
"building":"騰訊大廈",
"floor":"18F",
"equipment":[1,2,3],
"coordinate":
{
"latitude":"22.540503",
"longitude":"113.934528"
}
}
引數說明:
引數 |
必須 |
說明 |
access_token |
是 |
呼叫介面憑證 |
name |
是 |
會議室名稱,最多30個字元 |
capacity |
是 |
會議室所能容納的人數 |
city |
否 |
會議室所在城市 |
building |
否 |
會議室所在樓宇 |
floor |
否 |
會議室所在樓層 |
equipment |
否 |
會議室支援的裝置列表,引數詳細含義見附錄 |
coordinate.latitude |
否 |
會議室所在建築緯度,可通過騰訊地圖座標拾取器 獲取 |
coordinate.longitude |
否 |
會議室所在建築經度,可通過騰訊地圖座標拾取器 獲取 |
選擇 body -- json格式
根據文件說明,新增資料。
{
"name":"18F-會議室",
"capacity":10
}
點選 【send】檢視伺服器返回結果、