Skip to content

Latest commit

 

History

History
144 lines (108 loc) · 5.74 KB

report.md

File metadata and controls

144 lines (108 loc) · 5.74 KB
Raw

视频观看数据上报

上报观看进度（双端）

https://api.bilibili.com/x/v2/history/report

请求方式：POST

认证方式：APP或Cookie（SESSDATA）

正文参数（ application/x-www-form-urlencoded ）：

参数名 类型 内容 必要性 备注
access_key str APP登录Token APP方式必要
aid num 稿件avid 必要
cid num 视频cid 必要 用于识别分P
progress num 观看进度 非必要 单位为秒
默认为0
platform str 平台标识 非必要 可为android
csrf str CSRF Token（位于cookie） Cookie方式必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
message str 错误信息 默认为0
ttl num 1

示例：

记录视频av13662970（cid=126654047）的观看记录位于1248秒

Cookie方式：

curl 'https://api.bilibili.com/x/v2/history/report' \
--data-urlencode 'aid=13662970' \
--data-urlencode 'cid=126654047' \
--data-urlencode 'progress=1248' \
--data-urlencode 'platform=android' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'

APP方式：

curl 'https://api.bilibili.com/x/v2/history/report' \
--data-urlencode 'access_key=xxx' \
--data-urlencode 'aid=13662970' \
--data-urlencode 'cid=126654047' \
--data-urlencode 'progress=1248' \
--data-urlencode 'platform=android'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

上报视频播放心跳（web端）

https://api.bilibili.com/x/click-interface/web/heartbeat

请求方式：POST

认证方式：仅可Cookie（SESSDATA）

默认间隔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 当前用户mid 非必要
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 CSRF Token（位于cookie） 非必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-400：请求错误
message str 错误信息 默认为0
ttl num 1

示例：

上报一次视频av2/BV1xx411c7mD的心跳数据

curl 'https://api.bilibili.com/x/click-interface/web/heartbeat' \
--data-urlencode 'aid=2' \
--data-urlencode 'bvid=BV1xx411c7mD' \
--data-urlencode 'cid=62131' \
--data-urlencode 'played_time=60' \
--data-urlencode 'realtime=60' \
--data-urlencode 'start_ts=1592720840' \
--data-urlencode 'type=3' \
--data-urlencode 'dt=2' \
--data-urlencode 'play_type=0' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1
}