本页所有操作均需登录(SESSDATA)
方式:POST
正文参数( application/x-www-form-urlencoded ):
参数名 | 类型 | 内容 | 必要性 | 备注 |
---|---|---|---|---|
aid | num | 视频avID | 必要 | |
cid | num | 视频CID | 必要 | 用于识别分P |
progress | num | 观看进度 | 非必要 | 单位为秒 默认为0 |
csrf | str | cookies中的bili_jct | 必要 |
json回复:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
code | num | 返回值 | 0:成功 -101:账号未登录 -111:csrf校验失败 -400:请求错误 |
message | str | 错误信息 | 默认为0 |
ttl | num | 1 | 作用尚不明确 |
示例:
记录视频av13662970
(CID=126654047
)的观看记录位于1248
秒
curl -b "SESSDATA=xxx" -d "aid=13662970&cid=126654047&progress=1248&csrf=xxx" "http://api.bilibili.com/x/v2/history/report"
{
"code": 0,
"message": "0",
"ttl": 1
}
方式:POST
默认间隔15秒一次
亦可记录播放历史
正文参数( application/x-www-form-urlencoded ):
参数名 | 类型 | 内容 | 必要性 | 备注 |
---|---|---|---|---|
aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
cid | num | 视频CID | 非必要 | 用于识别分P |
epid | num | 番剧epID | 非必要 | |
sid | num | 番剧ssID | 非必要 | |
mid | num | 当前用户UID | 非必要 | |
played_time | num | 视频播放进度 | 非必要 | 单位为秒 默认为0 |
realtime | num | 总计播放时间 | 非必要 | 单位为秒 |
start_ts | num | 开始播放时刻 | 非必要 | 时间戳 |
type | num | 视频类型 | 非必要 | 3:投稿视频 4:剧集 10:课程 |
sub_type | num | 剧集副类型 | 非必要 | 当type=4 时本参数有效1:番剧 2:电影 3:纪录片 4:国创 5:电视剧 7:综艺 |
dt | num | 2 | 非必要 | |
play_type | num | 播放动作 | 非必要 | 0:播放中 1:开始播放 2:暂停 3:继续播放 |
csrf | str | cookies中的bili_jct | 非必要 |
json回复:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
code | num | 返回值 | 0:成功 -400:请求错误 |
message | str | 错误信息 | 默认为0 |
ttl | num | 1 | 作用尚不明确 |
示例:
上报一次视频av2
/BV1xx411c7mD
的心跳数据
{
"code": 0,
"message": "0",
"ttl": 1
}