优化，添加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,87 @@
+## 获取上传凭证
+
+### 基本信息
+
+| 属性       | 内容                            |
+|:---------|:------------------------------|
+| 接口名称     | 获取上传凭证                      |
+| 接口版本     | v1.0                          |
+| 接口路径     | /upload/get_token             |
+| 请求方法     | GET                           |
+| 接口状态     | 生产环境                          |
+
+### 接口说明
+
+获取对象存储上传域名和临时上传凭证。
+
+### 接口地址
+
+```
+https://proapi.115.com/open/upload/get_token
+```
+
+### 请求方式
+
+```
+GET
+```
+
+### 认证方式
+
+```
+Authorization: Bearer access_token
+```
+
+### 请求参数
+
+无
+
+### 请求示例
+
+```shell
+curl 'https://proapi.115.com/open/upload/get_token' \
+  -H 'Authorization: Bearer <ACCESS_TOKEN>'
+```
+
+### 响应字段说明
+
+| 字段                 | 类型    | 描述             |
+|:-------------------|:------|:---------------|
+| state              | boolean | 状态码，是表示成功，否表示异常 |
+| message            | string  | 异常信息           |
+| code               | int     | 异常码            |
+| data               | object  | 上传凭证数据         |
+| data.endpoint      | string  | 上传域名           |
+| data.AccessKeySecret | string  | 临时上传凭证密钥       |
+| data.SecurityToken | string  | 临时安全令牌         |
+| data.Expiration    | string  | 上传凭证过期时间       |
+| data.AccessKeyId   | string  | 临时上传凭证 ID      |
+
+### 响应示例
+
+```json
+{
+  "state": true,
+  "message": "",
+  "code": 0,
+  "data": {
+    "endpoint": "",
+    "AccessKeySecret": "",
+    "SecurityToken": "",
+    "Expiration": "",
+    "AccessKeyId": ""
+  }
+}
+```
+
+### 注意事项
+
+- 网页版文档中的密钥字段名存在拼写误差，服务端实际返回字段为 `AccessKeySecret`。
+- 上传凭证为敏感信息，仅用于当前上传流程；不要写入日志、持久化存储或对外暴露。
+- 服务端通过当前 `access_token` 识别用户，不接收用户账号请求参数。
+
+### 修改历史
+
+| 修改时间                         | 修改说明 |
+|:-----------------------------|:-----|
+| 2025年04月01日(周二) 00:00:00 | 创建文档 |