## 获取上传凭证

### 基本信息

| 属性       | 内容                            |
|:---------|:------------------------------|
| 接口名称     | 获取上传凭证                      |
| 接口版本     | 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 | 创建文档 |