mirror of
https://github.com/truewhile/MeBox.git
synced 2026-09-28 03:06:38 +08:00
truewhile
116 lines
4.4 KiB
Markdown
116 lines
4.4 KiB
Markdown
## 按路径获取
|
|
|
|
### 基本信息
|
|
|
|
| 属性 | 内容 |
|
|
|:-----------|:---------------------------------|
|
|
| 接口名称 | 按路径获取 |
|
|
| 接口版本 | v1.0 |
|
|
| 接口路径 | /get_info |
|
|
| 请求方法 | POST |
|
|
| 接口状态 | 生产环境 |
|
|
|
|
### 接口说明
|
|
|
|
根据文件或文件夹路径获取详情。
|
|
|
|
### 接口地址
|
|
|
|
```
|
|
https://proapi.115.com/open/folder/get_info
|
|
```
|
|
|
|
### 请求方式
|
|
|
|
```
|
|
POST
|
|
Content-Type: multipart/form-data
|
|
```
|
|
|
|
### 认证方式
|
|
|
|
```
|
|
Authorization: Bearer access_token
|
|
```
|
|
|
|
### 请求参数
|
|
|
|
| 参数名 | 类型 | 必填 | 默认值 | 说明 | 约束/示例 |
|
|
|:----|:-------|:---|:----|:----------------------------------------------------------------|:-------------------|
|
|
| path | string | 是 | - | 文件路径，支持 `/`、`>` 两种分隔符；路径需以分隔符开头，并用同一分隔符分隔目录层级 | /a/b/c.png 或 >a>b>c |
|
|
|
|
### 请求示例
|
|
|
|
```shell
|
|
curl 'https://proapi.115.com/open/folder/get_info' \
|
|
-H 'Authorization: Bearer access_token' \
|
|
--form-string 'path=/a/b/c.png'
|
|
```
|
|
|
|
### 响应字段说明
|
|
|
|
| 字段 | 类型 | 描述 |
|
|
|:----------------------|:---------|:----------------------------------------|
|
|
| state | boolean | 接口状态，true表示成功 |
|
|
| message | string | 异常信息 |
|
|
| code | int | 异常码 |
|
|
| data | object | 文件或文件夹详情 |
|
|
| data.count | int | 包含的文件总数 |
|
|
| data.size | string | 文件或文件夹总大小 |
|
|
| data.size_byte | int | 文件或文件夹总大小，单位为字节 |
|
|
| data.folder_count | int | 包含的文件夹总数 |
|
|
| data.play_long | int | 视频时长；`-1` 表示正在统计，其他数值单位为秒 |
|
|
| data.show_play_long | int | 是否开启展示视频时长 |
|
|
| data.ptime | string | 上传时间 |
|
|
| data.utime | string | 修改时间 |
|
|
| data.file_name | string | 文件或文件夹名称 |
|
|
| data.pick_code | string | 文件提取码 |
|
|
| data.sha1 | string | 文件SHA-1值 |
|
|
| data.file_id | string | 文件或文件夹ID |
|
|
| data.is_mark | string | 是否星标 |
|
|
| data.open_time | int | 文件或文件夹最近打开时间 |
|
|
| data.file_category | string | 文件属性：1-文件，0-文件夹 |
|
|
| data.paths | object[] | 文件或文件夹所在路径 |
|
|
| data.paths[].file_id | string | 父目录ID |
|
|
| data.paths[].file_name | string | 父目录名称 |
|
|
| data.paths[].iss | int | 父目录共享状态标识 |
|
|
|
|
### 响应示例
|
|
|
|
```json
|
|
{
|
|
"state": true,
|
|
"message": "",
|
|
"code": 0,
|
|
"data": {
|
|
"count": 0,
|
|
"size": "",
|
|
"size_byte": 0,
|
|
"folder_count": 0,
|
|
"play_long": 0,
|
|
"show_play_long": 0,
|
|
"ptime": "",
|
|
"utime": "",
|
|
"file_name": "",
|
|
"pick_code": "",
|
|
"sha1": "",
|
|
"file_id": "",
|
|
"is_mark": "",
|
|
"open_time": 0,
|
|
"file_category": "",
|
|
"paths": []
|
|
}
|
|
}
|
|
```
|
|
|
|
### 注意事项
|
|
|
|
- 文件或文件夹已进入回收站或被彻底删除时，接口返回异常。
|
|
- `user_id` 由服务端根据 access token 获取，无需传入。
|
|
|
|
### 修改历史
|
|
|
|
| 修改时间 | 修改说明 |
|
|
|:-----------------------------|:-----|
|
|
| 2025年04月01日(周二) 00:00:00 | 创建文档 |
|