添加视频心跳上报 并勘误

This commit is contained in:
SocialSisterYi 2020-06-21 15:38:08 +08:00
parent e0d5830da7
commit 7bb0a16f97
15 changed files with 163 additions and 110 deletions

View File

@ -22,7 +22,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------------- | ------ | ------------------------------------------------------------ |
| aid | num | 课程avID | 必要 | |
| avid | num | 课程avID | 必要 | |
| ep_id | num | 课程epID | 必要 | |
| cid | num | 视频CID | 必要 | |
| qn | num | 视频清晰度选择 | 非必要 | 未登录默认32480P<br />登录默认64720P<br />**值含义见下表** |

View File

@ -10,20 +10,20 @@
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ---------------------- | ------ | ------------------------------------------------------------ |
| type | num | 1 | 必要 | |
| oid | num | 视频CID | 必要 | |
| msg | str | 弹幕内容 | 必要 | 长度小于100字符 |
| bvid | str | 视频bvID | 必要 | avID与bvID任选一个 |
| aid | num | 视频avID | 必要 | avID与bvID任选一个 |
| progress | num | 弹幕出现在视频内的时间 | 非必要 | 单位为毫秒<br />默认为0 |
| color | num | 弹幕颜色设置 | 非必要 | 详见[「弹幕」中的属性 p](danmaku.md#属性 p)<br />默认为16777215#FFFFFF白色 |
| fontsize | num | 弹幕字号设置 | 非必要 | 详见[「弹幕」中的属性 p](danmaku.md#属性 p)<br />默认为25 |
| pool | num | 弹幕池选择 | 非必要 | 0普通弹幕<br />1字幕弹幕<br />2BAS弹幕<br />默认为0 |
| mode | num | 弹幕类型选择 | 必要 | 1普通<br />4底部<br />5顶部<br />7高级<br />9BAS`pool`必须为2 |
| rnd | num | 16位10进制随机数 | 非必要 | **若无此项则发送弹幕冷却时间限制为90s**<br />若有此项则发送弹幕冷却时间限制为5s |
| csrf | str | cookies中的bili_jct | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ---------------------- | ------------ | ------------------------------------------------------------ |
| type | num | 1 | 必要 | |
| oid | num | 视频CID | 必要 | |
| msg | str | 弹幕内容 | 必要 | 长度小于100字符 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| progress | num | 弹幕出现在视频内的时间 | 非必要 | 单位为毫秒<br />默认为0 |
| color | num | 弹幕颜色设置 | 非必要 | 详见[「弹幕」中的属性 p](danmaku.md#属性 p)<br />默认为16777215#FFFFFF白色 |
| fontsize | num | 弹幕字号设置 | 非必要 | 详见[「弹幕」中的属性 p](danmaku.md#属性 p)<br />默认为25 |
| pool | num | 弹幕池选择 | 非必要 | 0普通弹幕<br />1字幕弹幕<br />2BAS弹幕<br />默认为0 |
| mode | num | 弹幕类型选择 | 必要 | 1普通<br />4底部<br />5顶部<br />7高级<br />9BAS`pool`必须为2 |
| rnd | num | 16位10进制随机数 | 非必要 | **若无此项则发送弹幕冷却时间限制为90s**<br />若有此项则发送弹幕冷却时间限制为5s |
| csrf | str | cookies中的bili_jct | 必要 | |
**json回复**

View File

@ -139,11 +139,11 @@
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------ | ------ | ------------------ |
| mid | num | 目标用户UID | 必要 | |
| aid | num | 目标视频avID | 必要 | avID与bvID任选一个 |
| bvid | str | 目标视频bvID | 必要 | avID与bvID任选一个 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------ | ------------ | ------------------ |
| mid | num | 目标用户UID | 必要 | |
| aid | num | 目标视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 目标视频bvID | 必要(可选) | avID与bvID任选一个 |
**json回复**

View File

@ -62,7 +62,7 @@
| bangumi | obj | 番剧/影视信息 | 非番剧/影视无此项 |
| cheese | obj | 课程信息 | 非课程无此项 |
| favorite | bool | 是否已收藏 | true已收藏<br />false未收藏 |
| type | num | 视频属性 | 3普通视频<br />4番剧/影视<br />10课程 |
| type | num | 视频属性 | 3普通视频<br />4剧集<br />10课程 |
| sub_type | num | 附视频属性 | 0普通视频<br />1番剧<br />2电影<br />3纪录片<br />4国创<br />5电视剧<br />7综艺 |
| device | num | 观看设备 | 1 3 5 7手机端<br />2PC端<br />4 6PAD端<br />33TV端<br />0其他 |
| page | obj | 最后观看的分P信息 | |

View File

@ -14,11 +14,11 @@
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ------------------ |
| aid | num | 视频avID | 必要 | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要 | avID与bvID任选一个 |
| csrf | str | cookies中的bili_jct | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------------ | ------------------ |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| csrf | str | cookies中的bili_jct | 必要 | |
**json回复**

View File

@ -2322,12 +2322,12 @@ curl -b "SESSDATA=xxx;DedeUserID=1" -d "csrf=xxx&tags=minecraft%2C%E6%8A%80%E6%9
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ------------------ |
| aid | num | 置顶目标视频avID | 必要 | avID与bvID任选一个 |
| bvid | str | 置顶目标视频bvID | 必要 | avID与bvID任选一个 |
| reason | str | 置顶视频备注 | 非必要 | 置顶备注最大40字符 |
| csrf | str | cookies中的bili_jct | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------------ | -------------------------------- |
| aid | num | 置顶目标视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 置顶目标视频bvID | 必要(可选) | avID与bvID任选一个 |
| reason | str | 置顶视频备注 | 非必要 | 置顶备注最大40字符<br />默认为空 |
| csrf | str | cookies中的bili_jct | 必要 | |
**json回复**
@ -2407,12 +2407,12 @@ curl -b "SESSDATA=xxx" -d "csrf=xxx" "http://api.bilibili.com/x/space/top/arc/ca
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ------------------ |
| aid | num | 置顶目标视频avID | 必要 | avID与bvID任选一个 |
| bvid | str | 置顶目标视频bvID | 必要 | avID与bvID任选一个 |
| reason | str | 代表作备注 | 非必要 | 置顶备注最大40字符 |
| csrf | str | cookies中的bili_jct | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------------ | -------------------------------- |
| aid | num | 置顶目标视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 置顶目标视频bvID | 必要(可选) | avID与bvID任选一个 |
| reason | str | 代表作备注 | 非必要 | 置顶备注最大40字符<br />默认为空 |
| csrf | str | cookies中的bili_jct | 必要 | |
**json回复**
@ -2452,11 +2452,11 @@ curl -b "SESSDATA=xxx" -d "csrf=xxx&aid=94916552" "http://api.bilibili.com/x/spa
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------------------- | ------ | ------------------ |
| aid | num | 要删除的目标视频avID | 必要 | avID与bvID任选一个 |
| bvid | str | 要删除的目标视频bvID | 必要 | avID与bvID任选一个 |
| csrf | str | cookies中的bili_jct | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------------------- | ------------ | ------------------ |
| aid | num | 要删除的目标视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 要删除的目标视频bvID | 必要(可选) | avID与bvID任选一个 |
| csrf | str | cookies中的bili_jct | 必要 | |
**json回复**

View File

@ -10,10 +10,10 @@
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
| aid | num | 视频avID | 必要 | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要 | avID与bvID任选一个 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | ------------------ |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
**json回复**
@ -357,10 +357,10 @@ http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
| aid | num | 视频avID | 必要 | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要 | avID与bvID任选一个 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | ------------------ |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
**json回复**
@ -400,10 +400,10 @@ http://api.bilibili.com/x/web-interface/archive/desc?aid=39330059
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
| aid | num | 视频avID | 必要 | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要 | avID与bvID任选一个 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | ------------------ |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
**json回复**

View File

@ -14,12 +14,12 @@
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ---------------------- |
| aid | num | 视频avID | 必要 | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要 | avID与bvID任选一个 |
| like | num | 操作方式 | 必要 | 1点赞<br />2取消赞 |
| csrf | str | cookies中的bili_jct | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------------ | ---------------------- |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| like | num | 操作方式 | 必要 | 1点赞<br />2取消赞 |
| csrf | str | cookies中的bili_jct | 必要 | |
**json回复**
@ -59,13 +59,13 @@ curl -b "SESSDATA=xxx" -d "aid=79677524&like=1&csrf=xxx" "http://api.bilibili.co
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ----------- | ---- | ------------------- | ------ | --------------------------------------- |
| aid | num | 视频avID | 必要 | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要 | avID与bvID任选一个 |
| select_like | num | 附加点赞 | 非必要 | 0不点赞<br />1同时点赞<br />默认为0 |
| multiply | num | 投币数量 | 必要 | 上限为2 |
| csrf | str | cookies中的bili_jct | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ----------- | ---- | ------------------- | ------------ | --------------------------------------- |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| select_like | num | 附加点赞 | 非必要 | 0不点赞<br />1同时点赞<br />默认为0 |
| multiply | num | 投币数量 | 必要 | 上限为2 |
| csrf | str | cookies中的bili_jct | 必要 | |
**json回复**
@ -171,11 +171,11 @@ curl --referer "http://www.bilibili.com" -b "SESSDATA=xxx" -d "rid=90671873&type
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ------------------ |
| aid | num | 视频avID | 必要 | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要 | avID与bvID任选一个 |
| csrf | str | cookies中的bili_jct | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------------ | ------------------ |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| csrf | str | cookies中的bili_jct | 必要 | |
**json回复**
@ -287,10 +287,10 @@ http://api.bilibili.com/x/v2/fav/video/favoured?aid=46281123
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
| aid | num | 视频avID | 必要 | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要 | avID与bvID任选一个 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | ------------------ |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
**json回复**
@ -332,10 +332,10 @@ http://api.bilibili.com/x/web-interface/archive/has/like?aid=39330059
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
| aid | num | 视频avID | 必要 | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要 | avID与bvID任选一个 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | ------------------ |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
**json回复**

View File

@ -12,9 +12,9 @@
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----- | ------ | ---- |
| vid | num | 视CID | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------- | ------ | ---- |
| vid | num | 视CID | 必要 | |
**json回复**

View File

@ -10,10 +10,10 @@
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
| aid | num | 视频avID | 必要 | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要 | avID与bvID任选一个 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | ------------------ |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
**json回复**

View File

@ -19,8 +19,6 @@
**json回复**
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
@ -43,3 +41,58 @@ curl -b "SESSDATA=xxx" -d "aid=13662970&cid=126654047&progress=1248&csrf=xxx" "h
}
```
## 上报视频播放心跳web端
> http://api.bilibili.com/x/click-interface/web/heartbeat
*方式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 | 视频播放进度 | 非必要 | 单位为秒<br />默认为0 |
| realtime | num | 总计播放时间 | 非必要 | 单位为秒 |
| start_ts | num | 开始播放时刻 | 非必要 | 时间戳 |
| type | num | 视频类型 | 非必要 | 3投稿视频<br />4剧集<br />10课程 |
| sub_type | num | 剧集副类型 | 非必要 | 当`type=4`时本参数有效<br />1番剧<br />2电影<br />3纪录片<br />4国创<br />5电视剧<br />7综艺 |
| dt | num | 2 | 非必要 | |
| play_type | num | 播放动作 | 非必要 | 0播放中<br />1开始播放<br />2暂停<br />3继续播放 |
| csrf | str | cookies中的bili_jct | 非必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0成功<br />-400请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
**示例:**
上报一次视频`av2`/`BV1xx411c7mD`的心跳数据
http://api.bilibili.com/x/click-interface/web/heartbeat?aid=2&bvid=BV1xx411c7mD&cid=62131&played_time=60&realtime=60&start_ts=1592720840&type=3&dt=2&play_type=0&csrf=xxx
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```

View File

@ -13,12 +13,12 @@
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------ | ------ | ----------------------------------- |
| aid | num | 视频avID | 必要 | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要 | avID与bvID任选一个 |
| cid | num | 分P CID | 非必要 | 默认为1P |
| index | num | json数组截取时间表 | 非必要 | 1需要<br />0不需要<br />默认为0 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------ | ------------ | ----------------------------------- |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| cid | num | 分P CID | 非必要 | 默认为1P |
| index | num | json数组截取时间表 | 非必要 | 1需要<br />0不需要<br />默认为0 |
**json回复**

View File

@ -85,10 +85,10 @@ http://api.bilibili.com/archive_stat/stat?aid=91572143
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
| aid | num | 视频avID | 必要 | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要 | avID与bvID任选一个 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | ------------------ |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
**json回复**

View File

@ -8,10 +8,10 @@
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
| aid | num | 视频avID | 必要 | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要 | avID与bvID任选一个 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | ------------------ |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
**json回复**

View File

@ -20,12 +20,12 @@
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------------- | ------ | ------------------------------------------------------------ |
| aid | num | 视频avID | 必要 | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要 | avID与bvID任选一个 |
| cid | num | 视频CID | 必要 | |
| qn | num | 视频清晰度选择 | 非必要 | 未登录默认32480P<br />登录默认64720P<br />**值含义见下表** |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------------- | ------------ | ------------------------------------------------------------ |
| avid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| cid | num | 视频CID | 必要 | |
| qn | num | 视频清晰度选择 | 非必要 | 未登录默认32480P<br />登录默认64720P<br />**值含义见下表** |
分辨率代码: