MeBox/115doc/115开放平台/API列表/视频播放/记忆视频播放进度.md

记忆视频播放进度

基本信息

属性	内容
接口名称	记忆视频播放进度
接口版本	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

请求示例

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[]	响应数据，成功时为空数组

响应示例

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

业务规则

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

注意事项

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

修改历史

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