索引:/

文件名 大小 修改日期
📁 TianyiWorkstation 182.5GB 2021-11-19 19:03:53
📁 Archives 132.3GB 2021-02-23 17:47:49
📁 Microsoft Product ISO 72.4GB 2020-11-08 22:46:56
📁 OpenProjects 90.1MB 2021-07-11 01:31:51

欢迎使用 Joseph's OneDrive Storage Publication

请在使用时遵守您所居住的国家的相关法律法规。

API 文档

请求格式

本站使用基于 REST 风格的 HTTP API 协议,并选用 JSON 作为数据的交换格式。

请求方法与路径

GET https://odi.josephcz.xyz/<path>

其中,<path> 为需要列出的文件夹路径。必须以斜杠 / 结尾,否则会返回空数据。

请求所需的 HTTP 标头

API 与普通的 HTML 页面共用同一个 URL,并通过 HTTP 标头进行区别。因此,必须设置如下 HTTP 标头以获取正确的数据。

标头名 标头值
Accept application/files+json

请求示例

以下示例采用 cURL 命令为例。

请求根目录

curl -H "Accept: application/files+json" https://odi.josephcz.xyz/

请求特定目录

curl -H "Accept: application/files+json" https://odi.josephcz.xyz/Archives/LuoTianyiCollection/

响应

响应示例

{
	"code": 0,
	"message": "success",
	"data": {
		"readme": null,
		"files": [{
			"name": "BFSStorage",
			"size": 33307131052,
			"lastModifiedDateTime": 1624109969,
			"folder": true
		}, {
			"name": "2020 VSINGER LIVE演唱会特写机位.mp4",
			"size": 4526159284,
			"lastModifiedDateTime": 1598126669,
			"folder": false
		}]
	}
}

响应格式

响应总是为 JSON 格式,采用 UTF-8 编码,并设置 Content-Type: application/files+json 的 HTTP 标头。

字段名称 字段类型 字段说明
code int 响应代码
message string 人类可读的响应结果信息
data object? 响应数据。如果错误,则为空(null);如果正常,则返回相应数据。

响应的数据字段 data 格式如下:

字段名称 字段类型 字段说明
readme string? 如果请求的文件夹有附加的 HTML 说明,则返回字符串格式的 HTML 内容。如果没有,则为空(null)。
files File[] 一个“文件对象”组成的数组,包括所有的文件和文件名。
如果为空数组,则表示请求的文件夹为空。

文件对象

字段名称 字段类型 字段说明
name string 文件或文件夹的名称。
size int 以字节计算的文件大小,或文件夹的所有内容加总大小。
lastModifiedDateTime int(timestamp) 上次修改时间的时间戳。
folder bool 该项目是否是一个文件夹。

响应代码

一个典型的响应错误例子如下:

{
    "code":404,
    "message":"not found"
}
响应代码 响应说明
0 正常,有结果返回。
404 找不到请求的资源。