OneDrive API提供了對存儲在OneDrive上文件的訪問能力,大多數API都遵循REST模式,少部分的API可以通過簡單的函數來調用
在使用OneDrive API之前要先了解兩個簡單的概念
REST( Representational State Transfer):表征性狀態傳輸,是一種概念,或者說一種設計風格
Oauth(開放授權):是一開放標准,允許用戶提供一個令牌而不是用戶名和密碼來訪問他們存放在特定服務者(如OneDrive,百度雲盤等)上的數據,每一個令牌授權一個特定的網站在特定的時間段訪問特定的資源。OAuth允許用戶授權第三方(比如你開發的APP)訪問他們存儲在另外的服務提供者上的信息。
使用OneDrive的步驟
一、驗證你的應用程序
OneDrive使用OAuth2.0驗證,通過HTTP頭:Authorization: bearer {token}提供一個訪問令牌,你會得到一個存儲你的應用程序和用戶的一組特定權限的令牌
二、調用API
當應用程序獲得驗證后,你就可以調用OneDrive API來進行一些操作
OneDrive URI Root:https://api.onedrive.com/v1.0
在調用API之前,你需要了解一些關於OneDrive資源模型(Resource Model)的概念,OneDrive中有兩種資源類型:
Drive:頂級對象
Item:文件、文件夾等
想必你已看出這種資源模型和我們計算機上的類似,Drive代表某個驅動器,而Item表示驅動器內的文件或文件夾,一個用戶至少有一個Drive——默認的Drive
Root Resource
路徑 |
描述 |
/drive |
用戶默認的驅動器 |
/drives |
向經過授權驗證的用戶提供的驅動器列表 |
/drive/{drive-id} |
通過id訪問特定的驅動器 |
/drive/{drive-id}/root/children |
特定驅動器中根目錄下的item列表 |
/drive/items/{item-id} |
通過id訪問特定的item |
/drive/root:/path/to/file |
通過path訪問根目錄下的item |
/drive/items/{item-id}:/path/to/file |
通過相對於 特定id的item 的路徑來訪問文件 |
/drive/root:/path/to/file:/children |
相對於根目錄的path下的item列表 |
/drive/items/{item-id}:/path/to/file:/children |
相對於 特定id的item 的路徑下的item列表 |
注意上面有兩種用法,一種用id,另一種是用path,更多路徑用法請參照OneDrive API文檔:https://dev.onedrive.com/README.htm
以上就是一些基本概念和使用OneDrive API的兩個基本步驟,后面將會詳細的說明這兩個步驟的具體操作
說明:本文及后續更新的文章是在對OneDrive官方文檔的學習而來,內容可能相對較淺,寫的目的也只是為了大家相互交流,如有什么錯誤還望指正