发布网站搭建教程,搭建个网站,小城镇建设的网站中的主要观点,网站开发周总结上一篇文章我介绍了如何利用官方提供的Graph 浏览器快速体验Microsoft Graph强大功能#xff0c;这是极好的起点。官方的Graph浏览器力图用最简单的方式帮助您使用Microsoft Graph#xff0c;为此也隐藏了很多细节。为了帮助大家更好地理解Microsoft Graph的工作原理#xf…上一篇文章我介绍了如何利用官方提供的Graph 浏览器快速体验Microsoft Graph强大功能这是极好的起点。官方的Graph浏览器力图用最简单的方式帮助您使用Microsoft Graph为此也隐藏了很多细节。为了帮助大家更好地理解Microsoft Graph的工作原理例如要使用Microsoft Graph需要进行应用改程序注册OAuth的过程以及Token传递的方式等我专门再写一篇介绍如何通过其他第三方工具来体验Microsoft Graph。
我们可以在网络上找到很多进行REST API调用和测试的工具这一篇我给大家演示的是一款叫POSTMAN的工具。它的官方主页在 https://www.getpostman.com/,提供了针对MacOS,Windows,Linux的版本也提供了Chrome的插件你可以按需下载。 POSTMAN 有免费版和专业版就本文的需求来说免费版就够用了。 为了能通过POSTMAN来调用Microsoft Graph我们必须按照Microsoft Graph概述中介绍的三部曲首先要注册一个应用程序。 注册应用程序
我会有专门的文章来讲解注册应用程序的细节本文将演示一个注册好的应用程序如果你不想自己注册也可以用我的信息进行测试。 你可以通过Microsoft 账号登录https://apps.dev.microsoft.com/#/, 注册一个应用程序需要提供名称并且生成一个秘钥然后制定对应的平台申请必要的权限。
发起POSTMAN请求
打开POSTMAN默认情况下如果去调用Microsoft Graph因为没有提供身份会返回如下的错误信息 这很容易理解我们接下来要做就是为POSTMAN添加OAuth的认证。选择上图中Authorization这个选项卡中的Type为“OAuth 2.0, 然后点击“Get New Access Token按钮在弹出的对话框中填写你注册好的应用程序信息。 如果你在此前的注册应用程序中遇到障碍请直接使用我准备好的测试应用程序信息
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”按钮POSTMAN会弹出跳转到Microsoft Graph的认证页面此时你可以输入Office 365的账号信息。 如果你输入了合法的账号信息接下来应用程序将会请求你的授权 点击上图中的“Accept”按钮正常情况下会关闭所有弹出的窗口并且返回到POSTMAN的主界面你现在就可以查看到当前申请得到的访问凭据(Access Token)了。 这里特别提一下我发现有时候同样的操作却不能成功可能受到一些网络方面的干扰因素吧请大家遇到这种情况的话耐心地重试一两次。 点击最右侧的“Use Token按钮可以将Access Token插入到当前的请求中去注意观察“Headers”这个选项卡的变化 (Authorization:Bearer xxxxxxxxx)然后点击“Send”按钮我们就可以顺利地完成当前的Microsoft Graph调用了。 请注意确保“Add token to” 这里选择“Header” 看起来不错吧你是不是会说这看起来也跟Graph 浏览器差别不大啊。是的到目前为止这都属于最基本的操作接下来我介绍一下POSTMAN的一些亮点功能。
保存请求对请求进行测试
保存请求
这是首先吸引我的功能也是很自然的需求如果能把上面的请求设置保存起来那么下一次我就可以直接使用而不需要重复地去输入了。
点击上图中的最右侧的“Save”按钮然后在弹出的对话框中输入Request Name等信息即可。 在保存请求的时候我们还可以将其归类到一个集合collection中去。如果你还没有创建集合则可以选择创建一个新的集合
我这里将几个常见的请求保存成了一个Office 365 devlab的集合如下图所示 对请求进行测试
POSTMAN还有一个较有意思的功能就是支持对一个集合的请求进行测试。点击上图左上角的“Runner”在弹出的窗口中选择一个保存好的collection进行一些简单的参数设置后点击“Start Test”按钮它会依次发起集合中的请求并且将返回结果一一显示。 POSTMAN 还有命令行工具可以便于脚本化进行测试限于篇幅本文就不做展开了。 POSTMAN的专业版还有一些高级功能例如团队协作之类的有兴趣的朋友可以自行尝试。
结语
POSTMAN是一个不错的第三方工具在同类的REST API 客户端工具中的优势在于图形化界面比较友好而且对OAuth的强大支持同时它还可以保存请求并且进行批量测试这将为我们体验Micrsooft Graph打开一扇方便之门并且也有助于更好地理解Microsoft Graph的工作原理。
