【转】通过第三方工具体验MicrosoftGraph

上一篇文章我介绍了如何利用官方提供的Graph 浏览器快速体验Microsoft Graph强大功能&＃xff0c;这是极好的起点。官方的Graph浏览器力图用最简单的方式帮助您使用Microsoft Graph&＃xff0c;为此也隐藏了很多细节。为了帮助大家更好地理解Microsoft Graph的工作原理&＃xff0c;例如要使用Microsoft Graph需要进行应用改程序注册&＃xff0c;OAuth的过程以及Token传递的方式等&＃xff0c;我专门再写一篇&＃xff0c;介绍如何通过其他第三方工具来体验Microsoft Graph。

我们可以在网络上找到很多进行REST API调用和测试的工具&＃xff0c;这一篇我给大家演示的是一款叫POSTMAN的工具。它的官方主页在 https://www.getpostman.com/,提供了针对MacOS,Windows,Linux的版本&＃xff0c;也提供了Chrome的插件&＃xff0c;你可以按需下载。

POSTMAN 有免费版和专业版&＃xff0c;就本文的需求来说&＃xff0c;免费版就够用了。

为了能通过POSTMAN来调用Microsoft Graph&＃xff0c;我们必须按照Microsoft Graph概述中介绍的三部曲&＃xff0c;首先要注册一个应用程序。

注册应用程序

我会有专门的文章来讲解注册应用程序的细节&＃xff0c;本文将演示一个注册好的应用程序&＃xff0c;如果你不想自己注册&＃xff0c;也可以用我的信息进行测试。

你可以通过Microsoft 账号登录https://apps.dev.microsoft.com/#/, 注册一个应用程序&＃xff0c;需要提供名称&＃xff0c;并且生成一个秘钥&＃xff0c;然后制定对应的平台&＃xff0c;申请必要的权限。

发起POSTMAN请求

打开POSTMAN&＃xff0c;默认情况下&＃xff0c;如果去调用Microsoft Graph&＃xff0c;因为没有提供身份&＃xff0c;会返回如下的错误信息

这很容易理解&＃xff0c;我们接下来要做就是为POSTMAN添加OAuth的认证。选择上图中"Authorization"这个选项卡中的Type为“OAuth 2.0", 然后点击“Get New Access Token"按钮&＃xff0c;在弹出的对话框中填写你注册好的应用程序信息。

如果你在此前的注册应用程序中遇到障碍&＃xff0c;请直接使用我准备好的测试应用程序信息&＃xff1a;

Auth URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Access Token URL: https://login.microsoftonline.com/common/oauth2/v2.0/token
ClinetID: 61df125c-f335-448e-8110-e6ab785a85f3
Client Secret: uCs9wjhyZok9EULEVPcjAfW
Scope: user.read mail.read mail.send


点击上图中的“Request Token”按钮&＃xff0c;POSTMAN会弹出跳转到Microsoft Graph的认证页面&＃xff0c;此时你可以输入Office 365的账号信息。

如果你输入了合法的账号信息&＃xff0c;接下来应用程序将会请求你的授权

点击上图中的“Accept”按钮&＃xff0c;正常情况下会关闭所有弹出的窗口&＃xff0c;并且返回到POSTMAN的主界面&＃xff0c;你现在就可以查看到当前申请得到的访问凭据(Access Token)了。

这里特别提一下&＃xff0c;我发现有时候同样的操作却不能成功&＃xff0c;可能受到一些网络方面的干扰因素吧&＃xff0c;请大家遇到这种情况的话&＃xff0c;耐心地重试一两次。

点击最右侧的“Use Token"按钮&＃xff0c;可以将Access Token插入到当前的请求中去&＃xff0c;注意观察“Headers”这个选项卡的变化 (Authorization:Bearer xxxxxxxxx)&＃xff0c;然后点击“Send”按钮&＃xff0c;我们就可以顺利地完成当前的Microsoft Graph调用了。

请注意确保“Add token to” 这里选择“Header”

看起来不错吧&＃xff1f;你是不是会说&＃xff0c;这看起来也跟Graph 浏览器差别不大啊。是的&＃xff0c;到目前为止&＃xff0c;这都属于最基本的操作&＃xff0c;接下来我介绍一下POSTMAN的一些亮点功能。

1. 保存请求
2. 对请求进行测试

保存请求

这是首先吸引我的功能&＃xff0c;也是很自然的需求&＃xff1a;如果能把上面的请求设置保存起来&＃xff0c;那么下一次我就可以直接使用而不需要重复地去输入了。

点击上图中的最右侧的“Save”按钮&＃xff0c;然后在弹出的对话框中输入Request Name等信息即可。

在保存请求的时候&＃xff0c;我们还可以将其归类到一个集合&＃xff08;collection&＃xff09;中去。&＃xff08;如果你还没有创建集合&＃xff0c;则可以选择创建一个新的集合&＃xff09;

我这里将几个常见的请求保存成了一个Office 365 devlab的集合&＃xff0c;如下图所示

对请求进行测试

POSTMAN还有一个较有意思的功能&＃xff0c;就是支持对一个集合的请求进行测试。点击上图左上角的“Runner”&＃xff0c;在弹出的窗口中选择一个保存好的collection&＃xff0c;进行一些简单的参数设置后&＃xff0c;点击“Start Test”按钮&＃xff0c;它会依次发起集合中的请求&＃xff0c;并且将返回结果一一显示。

POSTMAN 还有命令行工具&＃xff0c;可以便于脚本化进行测试&＃xff0c;限于篇幅本文就不做展开了。

POSTMAN的专业版还有一些高级功能&＃xff0c;例如团队协作之类的&＃xff0c;有兴趣的朋友可以自行尝试。

结语

POSTMAN是一个不错的第三方工具&＃xff0c;在同类的REST API 客户端工具中的优势在于图形化界面比较友好&＃xff0c;而且对OAuth的强大支持&＃xff0c;同时它还可以保存请求并且进行批量测试&＃xff0c;这将为我们体验Micrsooft Graph打开一扇方便之门&＃xff0c;并且也有助于更好地理解Microsoft Graph的工作原理。