Microsoft Graph for Office 365請求語法

Justin-Liu發表於2018-12-17

部落格地址:http://blog.csdn.net/FoxDave
本篇我們對Microsoft Graph的請求語法進行一下分析。
在這裡插入圖片描述
語法
https://graph.microsoft.com/{version}/{resource}/{id}/{property}?{query-parameters}

HTTP動詞
Microsoft Graph接受以下HTTP請求動詞以確定要執行的操作:

  • GET - 從資源讀取資料
  • POST - 建立新的資源或執行一個操作
  • PATCH - 用新值更新資源
  • PUT - 用新的資源替換已存在的
  • DELETE - 刪除資源

版本
Microsoft Graph當前支援以下兩個版本:

  • v1.0 - 用於生產環境應用程式的常規可用API。
  • beta - 可以理解為搶鮮版,裡面包含了一些預覽版的API,但是可能會包含破環性的更新,因此推薦用於開發或測試目的。

通過對比我們可以發現beta版本的API的一些特定端點包含額外的屬性和格式,或一些來自於v1.0的等效變化。
對於Graph做了哪些具體的更新,我們可以通過此頁面檢視。

資源
頂級的端點,指定我們的請求要跟哪個服務進行互動。包含但不限於以下這些:

  • Users
  • Groups
  • Sites
  • Drives
  • Me
  • Devices

很多資源相互之間都是有聯絡的,這使得橫向訪問Graph變得容易。例如,/me/drive,/users/{id}/events等。

Id (可選項)
指定集合中的成員如一個獨立的使用者、組、網站等。

屬性 (可選項)
指定父資源的某個屬性。

查詢引數 (可選項)
修改請求的響應來過濾結果,包含或排除屬性、對結果進行排序等。

相關文章