mirror of
https://github.com/truewhile/MeBox.git
synced 2026-09-28 03:06:38 +08:00
truewhile
88 lines
2.2 KiB
Markdown
88 lines
2.2 KiB
Markdown
## 获取上传凭证
|
|
|
|
### 基本信息
|
|
|
|
| 属性 | 内容 |
|
|
|:---------|:------------------------------|
|
|
| 接口名称 | 获取上传凭证 |
|
|
| 接口版本 | 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 | 创建文档 |
|