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官方文档的学习而来,内容可能相对较浅,写的目的也只是为了大家相互交流,如有什么错误还望指正