一、前言
凡是做過移動端測試的同學,相信對OpenSTF都不陌生,該項目來自Github開源項目(看源碼)。
在搭建自己的測試平臺時,會利用STF的API進行設備遠程佔用、釋放,以及獲取設備信息,本文即爲大家講解STF的API,其實很簡單。
OpenSTF平臺界面,如下圖:
(1)設備列表頁
(2)設備遠程會話頁
二、生成令牌
前提:在整個接口調用過程中,都需要訪問令牌,所以需先生成令牌。
說明:在web頁面生成訪問令牌,該令牌包含在每個請求中
三、OpenSTF常用接口
1、獲取用戶信息
Method: GET
URL: http://stf.zxtest.com/api/v1/user
Header:
Authorization: Bearer d934206703ce456db5c45fa84b5fe1783354a552876744cb8f0a3bd913fdb68f
2、列出所有STF設備(包括斷開連接或其他無法訪問的設備)
Method: GET
URL: http://stf.zxtest.com/api/v1/devices
Header: Authorization: Bearer d934206703ce456db5c45fa84b5fe1783354a552876744cb8f0a3bd913fdb68f
3、返回有關特定設備的信息
Method:GET
URL:http://stf.zxtest.com/api/v1/devices/FA6990313540
Header: Authorization: Bearer d934206703ce456db5c45fa84b5fe1783354a552876744cb8f0a3bd913fdb68f
4、返回有關您自己(經過身份驗證的用戶)的信息
Method:GET
URL:http://stf.zxtest.com//api/v1/user
Header: Authorization: Bearer d934206703ce456db5c45fa84b5fe1783354a552876744cb8f0a3bd913fdb68f
5、返回經過身份驗證的用戶當前正在使用的設備的列表
Method:GET
URL:http://stf.zxtest.com/api/v1/user/devices
Header: Authorization: Bearer d934206703ce456db5c45fa84b5fe1783354a552876744cb8f0a3bd913fdb68f
6、嘗試在經過身份驗證的用戶控制下添加設備。 這類似於在UI中按下“使用”
Method:POST
URL:http://stf.zxtest.com/api/v1/user/devices
Header:
(1)Authorization: Bearer d934206703ce456db5c45fa84b5fe1783354a552876744cb8f0a3bd913fdb68f
(2)Content-Type:application/json
Body:{"serial":"FA6990313540”}
7、從經過身份驗證的用戶的設備列表中刪除設備。 這類似於在UI中按下“停止使用”
Method:DELETE
URL:http://stf.zxtest.com/api/v1/user/devices/FA6990313540
Header:Authorization: Bearer d934206703ce456db5c45fa84b5fe1783354a552876744cb8f0a3bd913fdb68f
8、獲取設備遠程連接url
Method:POST
URL:http://stf.zxtest.com/api/v1/user/devices/FA6990313540/remoteConnect
Header:Authorization: Bearer d934206703ce456db5c45fa84b5fe1783354a552876744cb8f0a3bd913fdb68f
9、斷開設備遠程調試會話
Method:DELETE
URL:http://stf.zxtest.com/api/v1/user/devices/FA6990313540/remoteConnect
Header:Authorization: Bearer d934206703ce456db5c45fa84b5fe1783354a552876744cb8f0a3bd913fdb68f
四、遠程使用設備接口順序
遠程請求設備的順序:
(1)添加設備(使用):6
(2)獲取遠程調試URL:8
(3)斷開設備遠程調試會話:9
(4)設備列表中刪除設備(停止使用):7