Graph Explore的使用介紹

我在Graph API開發中用的最多的測試工具就是Graph Explore，這個是微軟開發的網頁版的Graph API的測試工具，能知足我大部分需求。

訪問網址是：Graph Explorer - Microsoft Graph

基本界面以下：

 

 基本上分紅4個區域

1.用戶登陸

2.Graph API查詢的樣例和查詢歷史

3.用戶查詢

4.返回結果

 下面來一個個說明一下具體的做用。

1.用戶登陸

你能夠用本身申請到的office 365開發者帳號登陸。登陸後，點擊登陸名右邊的齒輪圖標，能夠進行下面的一些設置。第一項會引導你去Office 365的網站導入一些測試用的用戶、文檔等，若是你的Office 365網站沒有任何數據，使用沙箱是很是好的一個辦法。第三項是設置權限，你能夠在這裏提早受權你須要的權限，若是沒作也不要緊，後面在每一條請求的時候，也能夠作相似的操做。

 

 2.查詢樣例和歷史

這裏提供了不少Graph API的查詢樣例，雙擊後就能夠直接顯示到右邊的查詢窗口，很是方便。可是這裏提供的大可能是最基本的一些查詢，更多的仍是須要本身在查詢窗口自行建立。

 

 歷史tab下面能夠保存你過去30天全部的查詢記錄，包括成功的和失敗的。你也能夠導出和刪除全部記錄。

 

下面來講一說最重要的兩個部分。

3. 用戶查詢。

首先是選擇HTTP請求的方法，一共有5個方法可選。

 

 

而後選擇Graph API的版本，大部分狀況下使用1.0就能夠了。有的查詢命令只在beta裏面有，可是微軟官方說在beta中的查詢命令，可能隨着新版本的發佈會進入到1.0中，而後從beta裏面刪除，因此開發中仍是儘可能使用1.0版本，以避免程序後續查詢失敗。

 

 查詢命令輸入，這裏測試一條查詢，獲得個人Office 365測試環境中全部的用戶數。返回結果一下子再看。

 

 Request Body裏面是使用Post，Put，Patch，Delete方法時，輸入一些查詢條件。好比下面示例，是在Office 365中新增一個用戶。Request body裏面就是這個用戶的一些詳細信息，一般是JSON格式的。

 

 Request Header裏面是填寫HTTP request headers。

 

 當你的查詢請求返回401未受權結果時，就能夠到Modify permissions下面檢查你的權限。若是沒授予權限的時候，status欄的consent會是一個藍色按鈕，按下便可。

 最後的Access Token，你能夠複製它，用於測試，也能夠點擊大括號按鈕，去jwt.ms網站查看token的具體內容。

 

 

 4. 查詢結果

首先最上面是查詢返回結果的狀態，常見的200，401，404.

Response preview。能夠看到以前查詢的返回結果是23.

 

 Response headers

 

 Code snippets，這裏是對開發人員最有用的部分了。根據你的查詢，這裏會給出相應的C#，JavaScript的代碼片斷。可是要注意的是，不是任何查詢都給出代碼片斷的，我的感受應該是最經常使用的一些查詢會有代碼片斷。

 

 Toolkit component 和 Adaptive cards也不是全部查詢都會有顯示結果。在開發中用到的機會也很少。

 

 以上就是Graph Explore使用介紹了，之後有機會再寫寫用Postman進行查詢測試的方法。