mirror of
https://github.com/SocialSisterYi/bilibili-API-collect.git
synced 2025-01-04 08:50:07 +08:00
46 lines
1.6 KiB
Markdown
46 lines
1.6 KiB
Markdown
|
# 视频观看数据上报
|
|||
|
|
|
|||
|
|
**本页所有操作均需登录（SESSDATA）**
|
|||
|
|
|
|||
|
|
## 上报观看进度（暂不支持bvID）
|
|||
|
|
|
|||
|
|
> http://api.bilibili.com/x/v2/history/report
|
|||
|
|
|
|||
|
|
*方式：POST*
|
|||
|
|
|
|||
|
|
**正文参数（ application/x-www-form-urlencoded ）：**
|
|||
|
|
|
|||
|
|
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
|||
|
|
| -------- | ---- | ------------------- | ------ | --------------------- |
|
|||
|
|
| aid | num | 视频avID | 必要 | |
|
|||
|
|
| cid | num | 视频CID | 必要 | 用于识别分P |
|
|||
|
|
| progress | num | 观看进度 | 非必要 | 单位为秒<br />默认为0 |
|
|||
|
|
| csrf | str | cookies中的bili_jct | 必要 | |
|
|||
|
|
|
|||
|
|
**json回复：**
|
|||
|
|
|
|||
|
|
**json回复：**
|
|||
|
|
|
|||
|
|
根对象：
|
|||
|
|
|
|||
|
|
| 字段 | 类型 | 内容 | 备注 |
|
|||
|
|
| ------- | ---- | -------- | ------------------------------------------------------------ |
|
|||
|
|
| code | num | 返回值 | 0：成功 <br />-101：账号未登录<br />-111：csrf校验失败<br />-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"
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"code": 0,
|
|||
|
|
"message": "0",
|
|||
|
|
"ttl": 1
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|