【转】通过第三方工具体验Microsoft Graph
上一篇文章我介紹了如何利用官方提供的Graph 瀏覽器快速體驗Microsoft Graph強(qiáng)大功能,這是極好的起點(diǎn)。官方的Graph瀏覽器力圖用最簡單的方式幫助您使用Microsoft Graph,為此也隱藏了很多細(xì)節(jié)。為了幫助大家更好地理解Microsoft Graph的工作原理,例如要使用Microsoft Graph需要進(jìn)行應(yīng)用改程序注冊,OAuth的過程以及Token傳遞的方式等,我專門再寫一篇,介紹如何通過其他第三方工具來體驗Microsoft Graph。
我們可以在網(wǎng)絡(luò)上找到很多進(jìn)行REST API調(diào)用和測試的工具,這一篇我給大家演示的是一款叫POSTMAN的工具。它的官方主頁在?https://www.getpostman.com/,提供了針對MacOS,Windows,Linux的版本,也提供了Chrome的插件,你可以按需下載。
POSTMAN 有免費(fèi)版和專業(yè)版,就本文的需求來說,免費(fèi)版就夠用了。
為了能通過POSTMAN來調(diào)用Microsoft Graph,我們必須按照Microsoft Graph概述中介紹的三部曲,首先要注冊一個應(yīng)用程序。
?
注冊應(yīng)用程序
我會有專門的文章來講解注冊應(yīng)用程序的細(xì)節(jié),本文將演示一個注冊好的應(yīng)用程序,如果你不想自己注冊,也可以用我的信息進(jìn)行測試。
你可以通過Microsoft 賬號登錄https://apps.dev.microsoft.com/#/, 注冊一個應(yīng)用程序,需要提供名稱,并且生成一個秘鑰,然后制定對應(yīng)的平臺,申請必要的權(quán)限。
發(fā)起POSTMAN請求
打開POSTMAN,默認(rèn)情況下,如果去調(diào)用Microsoft Graph,因為沒有提供身份,會返回如下的錯誤信息
這很容易理解,我們接下來要做就是為POSTMAN添加OAuth的認(rèn)證。選擇上圖中"Authorization"這個選項卡中的Type為“OAuth 2.0", 然后點(diǎn)擊“Get New Access Token"按鈕,在彈出的對話框中填寫你注冊好的應(yīng)用程序信息。
如果你在此前的注冊應(yīng)用程序中遇到障礙,請直接使用我準(zhǔn)備好的測試應(yīng)用程序信息:
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點(diǎn)擊上圖中的“Request Token”按鈕,POSTMAN會彈出跳轉(zhuǎn)到Microsoft Graph的認(rèn)證頁面,此時你可以輸入Office 365的賬號信息。
如果你輸入了合法的賬號信息,接下來應(yīng)用程序?qū)埱竽愕氖跈?quán)
點(diǎn)擊上圖中的“Accept”按鈕,正常情況下會關(guān)閉所有彈出的窗口,并且返回到POSTMAN的主界面,你現(xiàn)在就可以查看到當(dāng)前申請得到的訪問憑據(jù)(Access Token)了。
這里特別提一下,我發(fā)現(xiàn)有時候同樣的操作卻不能成功,可能受到一些網(wǎng)絡(luò)方面的干擾因素吧,請大家遇到這種情況的話,耐心地重試一兩次。
點(diǎn)擊最右側(cè)的“Use Token"按鈕,可以將Access Token插入到當(dāng)前的請求中去,注意觀察“Headers”這個選項卡的變化 (Authorization:Bearer xxxxxxxxx),然后點(diǎn)擊“Send”按鈕,我們就可以順利地完成當(dāng)前的Microsoft Graph調(diào)用了。
請注意確保“Add token to” 這里選擇“Header”
看起來不錯吧?你是不是會說,這看起來也跟Graph 瀏覽器差別不大啊。是的,到目前為止,這都屬于最基本的操作,接下來我介紹一下POSTMAN的一些亮點(diǎn)功能。
保存請求
這是首先吸引我的功能,也是很自然的需求:如果能把上面的請求設(shè)置保存起來,那么下一次我就可以直接使用而不需要重復(fù)地去輸入了。
點(diǎn)擊上圖中的最右側(cè)的“Save”按鈕,然后在彈出的對話框中輸入Request Name等信息即可。
在保存請求的時候,我們還可以將其歸類到一個集合(collection)中去。(如果你還沒有創(chuàng)建集合,則可以選擇創(chuàng)建一個新的集合)
我這里將幾個常見的請求保存成了一個Office 365 devlab的集合,如下圖所示
對請求進(jìn)行測試
POSTMAN還有一個較有意思的功能,就是支持對一個集合的請求進(jìn)行測試。點(diǎn)擊上圖左上角的“Runner”,在彈出的窗口中選擇一個保存好的collection,進(jìn)行一些簡單的參數(shù)設(shè)置后,點(diǎn)擊“Start Test”按鈕,它會依次發(fā)起集合中的請求,并且將返回結(jié)果一一顯示。
POSTMAN 還有命令行工具,可以便于腳本化進(jìn)行測試,限于篇幅本文就不做展開了。
POSTMAN的專業(yè)版還有一些高級功能,例如團(tuán)隊協(xié)作之類的,有興趣的朋友可以自行嘗試。
結(jié)語
POSTMAN是一個不錯的第三方工具,在同類的REST API 客戶端工具中的優(yōu)勢在于圖形化界面比較友好,而且對OAuth的強(qiáng)大支持,同時它還可以保存請求并且進(jìn)行批量測試,這將為我們體驗Micrsooft Graph打開一扇方便之門,并且也有助于更好地理解Microsoft Graph的工作原理。
總結(jié)
以上是生活随笔為你收集整理的【转】通过第三方工具体验Microsoft Graph的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 传雷帝嘎嘎出演小丑女
- 下一篇: 新东方主播董宇辉回应爆火:是福气和荣幸