github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2024-12-27 13:00:29 +08:00
Code Issues Packages Projects Releases Wiki Activity

添加若干评论区明细 表情包明细 等等

Browse Source
This commit is contained in:
SocialSisterYi 2020-06-21 13:16:31 +08:00
parent 70e2afd3ed
commit e0d5830da7
12 changed files with 7175 additions and 126 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
README.md
View File

@ -35,9 +35,10 @@
- qq&微博登录 - qq&微博登录
- [登录基本信息](login/login_info.md)√ - [登录基本信息](login/login_info.md)√
- [个人中心](login/member_center.md)× - [个人中心](login/member_center.md)×
- [消息](msg) - [消息中心](message)
- [通知类消息](msg/msg.md)× - [通知类消息](message/msg.md)×
- [私信](msg/private_msg.md)× - [私信](message/private_msg.md)×
- [设置](message/config.md)×
- [用户](user) - [用户](user)
- [基本信息](user/info.md)√ - [基本信息](user/info.md)√
- [状态数](user/status_number.md)√ - [状态数](user/status_number.md)√
@ -55,13 +56,15 @@
- [播放&下载地址（视频流）](video/videostream_url.md)√ - [播放&下载地址（视频流）](video/videostream_url.md)√
- 互动视频 - 互动视频
- [高能进度条](video/pbp.md)√ - [高能进度条](video/pbp.md)√
- [信息（上报心跳及记录历史）](video/report.md)×
- 番剧（影视） - 番剧（影视）
- 基本信息 - 基本信息
- 状态数 - 状态数
- 操作 - 操作
- [视频弹幕](danmaku) - [视频弹幕](danmaku)
- [实时弹幕&弹幕格式](danmaku/danmaku_list.md)√ - protobuf实时弹幕
- [历史弹幕](danmaku/history.md)√ - [xml实时弹幕](danmaku/danmaku_xml.md)√
- [xml历史弹幕](danmaku/history.md)√
- [快照](danmaku/snapshot.md)√ - [快照](danmaku/snapshot.md)√
- [弹幕操作](danmaku/action.md)× - [弹幕操作](danmaku/action.md)×
- [专栏](article) - [专栏](article)
@ -87,7 +90,9 @@
- [评论区](comment) - [评论区](comment)
- [评论区明细](comment/comment_list.md)√ - [评论区明细](comment/comment_list.md)√
- [操作](comment/action.md)√ - [操作](comment/action.md)√
- 表情 - [表情](emoji)
- [表情及表情包信息](emoji/emoji_list.md)×
- 操作
- [创作中心](creativecenter) - [创作中心](creativecenter)
- [统计与数据](creativecenter/statistics&data.md)x - [统计与数据](creativecenter/statistics&data.md)x
- 列表查询相关 - 列表查询相关
@ -108,7 +113,7 @@
- 小视频 - 小视频
- 操作 - 操作
- [历史记录&稍后再看](history&toview) - [历史记录&稍后再看](history&toview)
- [历史记录](history&toview/play_history.md)√ - [历史记录](history&toview/history.md)√
- [稍后再看](history&toview/toview.md)√ - [稍后再看](history&toview/toview.md)√
- 收藏夹 - 收藏夹
- [课程](cheese) - [课程](cheese)
@ -133,8 +138,9 @@
- 哔哩哔哩游戏 - 哔哩哔哩游戏
- [其他](other) - [其他](other)
- [基于ip的地理位置查询](other/ip.md)√ - [基于ip的地理位置查询](other/ip.md)√
- [获取当前时间戳](other/time_stamp.md)√
B站专栏同步推出[《B站api研究记》](https://www.bilibili.com/read/readlist/rl207146)系列，欢迎关注 B站专栏同步推出[《B站api研究记》](https://www.bilibili.com/read/readlist/rl207146)系列（更新状态：咕咕......），~~欢迎关注~~
**注意：请勿滥用，仅用于学习和测试！** **注意：请勿滥用，仅用于学习和测试！**

2
broadcast/video_room.md
View File

@ -128,7 +128,7 @@
| 项 | 类型 | 内容 | 备注 | | 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ------------------------------------------------------------ | | ---- | ---- | ------------ | ------------------------------------------------------------ |
| 0 | str | 弹幕属性信息 | 详见[「弹幕」中的属性 p](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/danmaku/danmaku.md) | | 0 | str | 弹幕属性信息 | 详见[「弹幕」中的属性 p](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/danmaku/danmaku_xml.md) |
| 1 | str | 弹幕内容 | | | 1 | str | 弹幕内容 | |
**示例：** **示例：**

20
comment/action.md
View File

@ -26,12 +26,12 @@
根对象： 根对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------- | ----------------------------- | -------- | ------------------------------------------------------------ | | ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />12002：评论区已关闭<br />12006：没有该评论<br />12009：评论主体的type不合法<br />12025：评论字数过多<br />**（其他错误码有待补充）** | | code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />-509：请求过于频繁<br />12002：评论区已关闭<br />12006：没有该评论<br />12009：评论主体的type不合法<br />12016：评论内容包含敏感信息<br />12025：评论字数过多<br />12051：重复评论，请勿刷屏<br />**（其他错误码有待补充）** |
| message | str | 错误信息 | 默认为0 | | message | str | 错误信息 | <br /> |
| ttl | num | 1 | **作用尚不明确** | | ttl | num | 1 | **作用尚不明确** |
| data | 正确时：obj<br />错误时：null | 数据本体 | | | data | obj | 数据本体 | |
`data`对象： `data`对象：
@ -238,7 +238,7 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&message=%E6%B5%8B%E8%AF%95test%5
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ | | ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />12002：评论区已关闭<br />12006：没有该评论<br />12009：评论主体的type不合法<br />12011：不合法的赞或踩<br />**（其他错误码有待补充）** | | code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />-509：请求过于频繁<br />12002：评论区已关闭<br />12006：没有该评论<br />12009：评论主体的type不合法<br />12011：不合法的赞或踩<br />**（其他错误码有待补充）** |
| message | str | 错误信息 | 默认为0 | | message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | **作用尚不明确** | | ttl | num | 1 | **作用尚不明确** |
@ -282,7 +282,7 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&rpid=3039053308&action=1&csrf=xx
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ | | ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />12002：评论区已关闭<br />12006：没有该评论<br />12009：评论主体的type不合法<br />12011：不合法的赞或踩<br />**（其他错误码有待补充）** | | code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />-509：请求过于频繁<br />12002：评论区已关闭<br />12006：没有该评论<br />12009：评论主体的type不合法<br />12011：不合法的赞或踩<br />**（其他错误码有待补充）** |
| message | str | 错误信息 | 默认为0 | | message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | **作用尚不明确** | | ttl | num | 1 | **作用尚不明确** |
@ -325,7 +325,7 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&rpid=3039053308&action=1&csrf=xx
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ | | ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-403：权限不足<br />-404：无此项<br />12002：评论区已关闭<br />12009：评论主体的type不合法<br />12022：已经被删除了<br />**（其他错误码有待补充）** | | code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-403：权限不足<br />-404：无此项<br />-509：请求过于频繁<br />12002：评论区已关闭<br />12009：评论主体的type不合法<br />12022：已经被删除了<br />**（其他错误码有待补充）** |
| message | str | 错误信息 | 默认为0 | | message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | **作用尚不明确** | | ttl | num | 1 | **作用尚不明确** |
@ -369,7 +369,7 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&rpid=3039053308&csrf=xxx" "http:
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ | | ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-403：权限不足<br />-404：无此项<br />12002：评论区已关闭<br />12006：没有该评论<br />12009：评论主体的type不合法<br />12029：已经有置顶评论<br />12030：不能置顶非一级评论<br />**（其他错误码有待补充）** | | code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-403：权限不足<br />-404：无此项<br />-509：请求过于频繁<br />12002：评论区已关闭<br />12006：没有该评论<br />12009：评论主体的type不合法<br />12029：已经有置顶评论<br />12030：不能置顶非一级评论<br />**（其他错误码有待补充）** |
| message | str | 错误信息 | 默认为0 | | message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | **作用尚不明确** | | ttl | num | 1 | **作用尚不明确** |

1593
comment/comment_list.md
View File

File diff suppressed because it is too large Load Diff

4
danmaku/danmaku_list.md → danmaku/danmaku_xml.md
View File

@ -1,6 +1,4 @@
# 弹幕 # xml弹幕
获取的均为xml格式标准弹幕文件，下载至本地后加载
实时弹幕池容量有限（根据视频类型500-3000条不等），占满后再发送会使实时弹幕池底部的弹幕压入历史弹幕池（类似于堆栈） 实时弹幕池容量有限（根据视频类型500-3000条不等），占满后再发送会使实时弹幕池底部的弹幕压入历史弹幕池（类似于堆栈）

5356
emoji/emoji_list.md Normal file
View File

File diff suppressed because it is too large Load Diff

14
history&toview/play_history.md → history&toview/history.md
View File

@ -1,8 +1,8 @@
# 播放历史 # 历史记录
<img src="/imgs/history.png" width="25" height="25"/> <img src="/imgs/history.png" width="25" height="25"/>
## 获取视频播放历史 ## 获取视频历史记录
> http://api.bilibili.com/x/v2/history > http://api.bilibili.com/x/v2/history
@ -367,7 +367,7 @@ http://api.bilibili.com/x/v2/history?ps=5&pn=1
## 删除视频观看历史记录 ## 删除历史记录
> http://api.bilibili.com/x/v2/history/delete > http://api.bilibili.com/x/v2/history/delete
@ -377,10 +377,10 @@ http://api.bilibili.com/x/v2/history?ps=5&pn=1
**正文参数（ application/x-www-form-urlencoded ）：** **正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ------------------------ | | ------ | ---- | ------------------- | ------ | ------------------------------------------------------------ |
| kid | str | 删除的目标记录 | 必要 | 格式：archive_{视频avID} | | kid | str | 删除的目标记录 | 必要 | 视频：archive\_{视频avID}<br />直播：live_{直播间ID}<br />专栏：article\_{专栏cvID}<br />番剧（影视）：pgc\_{番剧ssID} |
| csrf | str | cookies中的bili_jct | 必要 | | | csrf | str | cookies中的bili_jct | 必要 | |
**json回复：** **json回复：**

205
login/login_info.md
View File

@ -1,5 +1,7 @@
# 登录基本信息 # 登录基本信息
**本页所有操作均需登录（SESSDATA）**
## 登录用户信息1（完整） ## 登录用户信息1（完整）
> http://api.bilibili.com/nav (带有转义) > http://api.bilibili.com/nav (带有转义)
@ -8,8 +10,6 @@
*方式:GET* *方式:GET*
需要登录(SESSDATA)
**json回复：** **json回复：**
根对象： 根对象：
@ -18,36 +18,39 @@
| ------- | ---- | -------- | ----------------------------- | | ------- | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录 | | code | num | 返回值 | 0：成功<br />-101：账号未登录 |
| message | str | 错误信息 | 默认为0 | | message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 | | ttl | num | 1 | **作用尚不明确** |
| data | obj | 信息本体 | | | data | obj | 信息本体 | |
`data`对象： `data`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ---------------- | ------------------------------- | | -------------------- | ---- | ---------------- | ------------------------------- |
| isLogin | bool | 是否已登录 | | | isLogin | bool | 是否已登录 | false：未登录<br />true：已登录 |
| email_verified | num | 是否验证邮箱地址 | 0：未验证<br />1：已验证 | | email_verified | num | 是否验证邮箱地址 | 0：未验证<br />1：已验证 |
| face | str | 登录用户头像url | | | face | str | 用户头像url | |
| level_info | obj | 等级信息 | | | level_info | obj | 等级信息 | |
| mid | num | 登录UID | | | mid | num | 用户UID | |
| mobile_verified | num | 是否验证手机号 | 0：未验证<br />1：已验证 | | mobile_verified | num | 是否验证手机号 | 0：未验证<br />1：已验证 |
| money | num | 拥有硬币数 | | | money | num | 拥有硬币数 | |
| moral | num | 当前节操值 | 上限70 | | moral | num | 当前节操值 | 上限70 |
| official | obj | 认证信息 | | | official | obj | 认证信息 | |
| officialVerify | obj | 认证信息2 | | | officialVerify | obj | 认证信息2 | |
| pendant | obj | 挂件信息 | | | pendant | obj | 头像框信息 | |
| scores | num | 0 | 作用尚不明确 | | scores | num | 0 | **作用尚不明确** |
| uname | str | 登录用户昵称 | | | uname | str | 用户昵称 | |
| vipDueDate | num | 大会员到期时间 | 毫秒 时间戳 | | vipDueDate | num | 大会员到期时间 | 毫秒 时间戳 |
| vipStatus | num | 会员开通状态 | 0：无<br />1：有 | | vipStatus | num | 会员开通状态 | 0：无<br />1：有 |
| vipType | num | 大会员类型 | 0：无<br />1：月度<br />2：年度 | | vipType | num | 大会员类型 | 0：无<br />1：月度<br />2：年度 |
| vip_pay_type | num | 会员开通状态 | 0：无<br />1：有 | | vip_pay_type | num | 会员开通状态 | 0：无<br />1：有 |
| vip_theme_type | num | 0 | 作用尚不明确 | | vip_theme_type | num | 0 | **作用尚不明确** |
| wallet | obj | B币信息 | | | vip_label | obj | 大会员信息 | |
| has_shop | bool | false | 作用尚不明确 | | vip_avatar_subscript | num | 是否显示会员图标 | 0：不显示<br />1：显示 |
| shop_url | str | 空 | 作用尚不明确 | | vip_nickname_color | str | 会员昵称颜色 | 颜色码 |
| allowance_count | num | 0 | 作用尚不明确 | | wallet | obj | B币信息 | |
| answer_status | num | 0 | 作用尚不明确 | | has_shop | bool | false | **作用尚不明确** |
| shop_url | str | 空 | **作用尚不明确** |
| allowance_count | num | 0 | **作用尚不明确** |
| answer_status | num | 0 | **作用尚不明确** |
`data`中的`level_info`对象： `data`中的`level_info`对象：
@ -76,21 +79,29 @@
`data`中的`pendant`对象： `data`中的`pendant`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | ----------- | ------------ | | ------ | ---- | ----------- | ---------------- |
| pid | num | 挂件id | | | pid | num | 挂件id | |
| name | str | 挂件名称 | | | name | str | 挂件名称 | |
| image | str | 挂件图片url | | | image | str | 挂件图片url | |
| expire | num | 0 | 作用尚不明确 | | expire | num | 0 | **作用尚不明确** |
`data`中的`vip_label`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------ | ---------------- |
| path | str | 空 | **作用尚不明确** |
| text | str | 会员类型文字 | |
| label_theme | str | 会员类型 | |
`data`中的`wallet`对象： `data`中的`wallet`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ------------- | ------------ | | --------------- | ---- | ------------- | ---------------- |
| mid | num | 登录用户UID | | | mid | num | 登录用户UID | |
| bcoin_balance | num | 拥有B币数 | | | bcoin_balance | num | 拥有B币数 | |
| coupon_balance | num | 每月奖励B币数 | | | coupon_balance | num | 每月奖励B币数 | |
| coupon_due_time | num | 0 | 作用尚不明确 | | coupon_due_time | num | 0 | **作用尚不明确** |
**示例：** **示例：**
@ -100,57 +111,65 @@ http://api.bilibili.com/x/web-interface/nav
```json ```json
{ {
"code": 0, "code": 0,
"message": "0", "message": "0",
"ttl": 1, "ttl": 1,
"data": { "data": {
"isLogin": true, "isLogin": true,
"email_verified": 1, "email_verified": 1,
"face": "http://i1.hdslb.com/bfs/face/480e2e98513aaeb65d2f2c76dbae750c4de722e9.jpg", "face": "http://i1.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
"level_info": { "level_info": {
"current_level": 5, "current_level": 5,
"current_min": 10800, "current_min": 10800,
"current_exp": 14270, "current_exp": 16269,
"next_exp": 28800 "next_exp": 28800
}, },
"mid": 293793435, "mid": 293793435,
"mobile_verified": 1, "mobile_verified": 1,
"money": 2.5, "money": 26.6,
"moral": 70, "moral": 70,
"official": { "official": {
"role": 0, "role": 0,
"title": "", "title": "",
"desc": "", "desc": "",
"type": -1 "type": -1
}, },
"officialVerify": { "officialVerify": {
"type": -1, "type": -1,
"desc": "" "desc": ""
}, },
"pendant": { "pendant": {
"pid": 1492, "pid": 1888,
"name": "2020拜年祭·典藏", "name": "泠鸢yousa",
"image": "http://i0.hdslb.com/bfs/face/6550f53324c330f201a528e70ef305cb10ac2c01.png", "image": "http://i0.hdslb.com/bfs/garb/item/3e66e712b8e70c6b02393c54ad5fd8d993eb39f9.png",
"expire": 0 "expire": 0,
}, "image_enhance": "http://i0.hdslb.com/bfs/garb/item/3e66e712b8e70c6b02393c54ad5fd8d993eb39f9.png"
"scores": 0, },
"uname": "社会易姐QwQ", "scores": 0,
"vipDueDate": 1612454400000, "uname": "社会易姐QwQ",
"vipStatus": 1, "vipDueDate": 1612454400000,
"vipType": 2, "vipStatus": 1,
"vip_pay_type": 1, "vipType": 2,
"vip_theme_type": 0, "vip_pay_type": 1,
"wallet": { "vip_theme_type": 0,
"mid": 293793435, "vip_label": {
"bcoin_balance": 10, "path": "",
"coupon_balance": 5, "text": "年度大会员",
"coupon_due_time": 0 "label_theme": "annual_vip"
}, },
"has_shop": false, "vip_avatar_subscript": 1,
"shop_url": "", "vip_nickname_color": "#FB7299",
"allowance_count": 0, "wallet": {
"answer_status": 0 "mid": 293793435,
} "bcoin_balance": 8,
"coupon_balance": 5,
"coupon_due_time": 0
},
"has_shop": false,
"shop_url": "",
"allowance_count": 0,
"answer_status": 0
}
} }
``` ```
@ -162,8 +181,6 @@ http://api.bilibili.com/x/web-interface/nav
*方式:GET* *方式:GET*
需要登录(SESSDATA)
需要验证DedeUserID存在且不为0 需要验证DedeUserID存在且不为0
**json回复：** **json回复：**
@ -242,8 +259,6 @@ http://account.bilibili.com/home/userInfo
*方式：GET* *方式：GET*
需要登录(SESSDATA)
**json回复：** **json回复：**
根对象： 根对象：

2
msg/msg.md → message/msg.md
View File

@ -1,4 +1,4 @@
# 消息 # 通知消息
**本页所有操作均需登录（SESSDATA）** **本页所有操作均需登录（SESSDATA）**

0
msg/private_msg.md → message/private_msg.md
View File

38
other/time_stamp.md Normal file
View File

@ -0,0 +1,38 @@
# 获取当前时间戳
> http://api.bilibili.com/x/report/click/now
*方式：GET*
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------ |
| code | num | 返回值 | 0：成功 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| data | obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ---- |
| now | num | 当前的时间戳 | |
**示例：**
http://api.bilibili.com/x/report/click/now
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"now": 1592666471
}
}
```

45
video/report.md Normal file
View File

@ -0,0 +1,45 @@
# 视频观看数据上报
**本页所有操作均需登录（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
}
```