## 记忆视频播放进度

### 基本信息

| 属性           | 内容                              |
|:-------------|:--------------------------------|
| 接口名称         | 记忆视频播放进度                        |
| 接口版本         | v1.0                            |
| 接口路径         | /history                        |
| 请求方法         | POST                            |
| 接口状态         | 生产环境                            |

### 接口说明

记录指定视频的播放进度及是否播放完毕。

### 接口地址

```
https://proapi.115.com/open/video/history
```

### 请求方式

```
POST
Content-Type: multipart/form-data
```

### 认证方式

```
Authorization: Bearer access_token
```

### 请求参数

| 参数名       | 类型     | 必填 | 默认值 | 说明                 | 约束/示例            |
|:----------|:-------|:---|:----|:-------------------|:-----------------|
| pick_code | string | 是  | -   | 视频文件提取码            | b53gu6z3hvqji8wrm |
| time      | int    | 否  | 0   | 视频播放进度，单位为秒        | 10               |
| watch_end | int    | 否  | 0   | 是否播放完毕，0：否；1：是     | 0                |

### 请求示例

```shell
curl 'https://proapi.115.com/open/video/history' \
  -H 'Authorization: Bearer <access_token>' \
  -F 'pick_code=b53gu6z3hvqji8wrm' \
  -F 'time=10' \
  -F 'watch_end=0'
```

### 响应字段说明

| 字段    | 类型       | 描述                    |
|:------|:---------|:----------------------|
| state | boolean  | 操作结果状态，true：成功；false：失败 |
| message | string | 返回信息，成功时为空字符串          |
| code  | int      | 错误码                   |
| data  | object[] | 响应数据，成功时为空数组            |

### 响应示例

```json
{
  "state": true,
  "message": "",
  "code": 0,
  "data": []
}
```

### 业务规则

- `time` 和 `watch_end` 均不传时，两个参数均按 `0` 处理，即播放进度为 0 秒且未播放完毕。
- 非本人文件不写入播放进度，但接口按操作成功返回。
- 同一视频未播放完毕的进度在 5 秒内重复上报时不重复持久化；标记为播放完毕时会立即持久化。

### 注意事项

- `access_token` 通过 `Authorization` 请求头传递，请将请求示例中的占位符替换为实际访问令牌。
- `pick_code` 必须属于当前授权用户可记录播放进度的视频文件。

### 修改历史

| 修改时间                         | 修改说明 |
|:-----------------------------|:-----|
| 2025年04月01日(周二) 00:00:00 | 创建文档 |