优化，添加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,98 @@
+## 获取文件下载地址
+
+### 基本信息
+
+| 属性         | 内容                              |
+|:-----------|:--------------------------------|
+| 接口名称       | 获取文件下载地址                        |
+| 接口版本       | v1.0                            |
+| 接口路径       | /downurl                        |
+| 请求方法       | POST                            |
+| 接口状态       | 生产环境                            |
+
+### 接口说明
+
+根据文件提取码获取文件下载地址。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/ufile/downurl
+```
+
+### 请求方式
+
+```
+POST
+Content-Type: multipart/form-data
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+| 参数名      | 类型     | 必填 | 默认值 | 说明    | 约束/示例            |
+|:---------|:-------|:---|:----|:------|:-----------------|
+| pick_code | string | 是  | -   | 文件提取码，多个提取码用半角逗号分隔 | dtctprlmfkl4exiok |
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/ufile/downurl' \
+  -H 'Authorization: Bearer access_token' \
+  --form-string 'pick_code=dtctprlmfkl4exiok'
+```
+
+### 响应字段说明
+
+| 字段                         | 类型      | 描述                         |
+|:---------------------------|:--------|:---------------------------|
+| state                      | boolean | 状态码，true 表示成功              |
+| message                    | string  | 错误信息                       |
+| code                       | int     | 错误码                        |
+| errno                      | int     | 下载地址获取失败时返回的错误码             |
+| data                       | object  | 响应数据                       |
+| data.{文件ID}                | object  | 以文件ID为键的文件下载信息              |
+| data.{文件ID}.file_name      | string  | 文件名                        |
+| data.{文件ID}.file_size      | int     | 文件大小，单位为字节                  |
+| data.{文件ID}.pick_code      | string  | 文件提取码                      |
+| data.{文件ID}.sha1           | string  | 文件 SHA1 值                   |
+| data.{文件ID}.url            | object  | 下载地址信息                     |
+| data.{文件ID}.url.url        | string  | 文件下载地址                     |
+| data.can_appeal            | boolean | 文件违规时是否可以申诉，按错误场景返回         |
+| data.want_appeal_id        | string  | 文件违规时的申诉标识，按错误场景返回          |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": {
+    "2323423573680609857": {
+      "file_name": "",
+      "file_size": 0,
+      "pick_code": "",
+      "sha1": "",
+      "url": {
+        "url": ""
+      }
+    }
+  }
+}
+```
+
+### 注意事项
+
+- `access_token` 由开放平台授权流程获取，并通过 `Authorization` 请求头传递。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |