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进行查询测试的方法。