优化，添加115接口文档

2026-10-14 00:56:37 +08:00 · 2026-09-05 14:32:58 +08:00
parent d00b14df55
commit 0e9fb2c937
57 changed files with 5682 additions and 76 deletions
@@ -0,0 +1,80 @@
+## 删除文件
+
+### 基本信息
+
+| 属性         | 内容                              |
+|:-----------|:--------------------------------|
+| 接口名称       | 删除文件                            |
+| 接口版本       | v1.0                            |
+| 接口路径       | /delete                         |
+| 请求方法       | POST                            |
+| 接口状态       | 生产环境                            |
+
+### 接口说明
+
+批量删除文件(夹)，删除操作异步执行并将目标移入回收站。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/ufile/delete
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名       | 类型     | 必填 | 默认值 | 说明                     | 约束/示例                                      |
+|:----------|:-------|:---|:----|:-----------------------|:-------------------------------------------|
+| file_ids   | string | 是  | -   | 需要删除的文件(夹)ID，多个ID用半角逗号分隔 | 3073323042143855813,3073323042143855822 |
+| parent_id  | string | 否  | 0   | 待删除文件(夹)所在的父目录ID        | 3073311192547189943                         |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/ufile/delete' \
+  -H 'Authorization: Bearer access_token' \
+  --form-string 'file_ids=3073323042143855813,3073323042143855822' \
+  --form-string 'parent_id=3073311192547189943'
+```
+
+### 响应字段说明
+
+| 字段      | 类型       | 描述               |
+|:--------|:---------|:-----------------|
+| state   | boolean  | 状态码，true 表示请求已受理 |
+| message | string   | 错误信息             |
+| code    | int      | 错误码              |
+| data    | string[] | 响应数据             |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": []
+}
+```
+
+### 注意事项
+
+- `access_token` 由开放平台授权流程获取，并通过 `Authorization` 请求头传递。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |