diff --git a/danmaku/action.md b/danmaku/action.md index 95a4b0c..cb4ab58 100644 --- a/danmaku/action.md +++ b/danmaku/action.md @@ -463,3 +463,212 @@ curl -G 'http://api.bilibili.com/x/dm/adv/state'\ ``` + +## 查询弹幕点赞数 + +> http://api.bilibili.com/x/v2/dm/thumbup/stats + +*请求方式:GET* + +认证方式:Cookie(SESSDATA)或APP + +**url参数:** +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | ------------ | ----------- | ------------------- | +| access_key | str | APP登录Token | APP方式必要 | | +| oid | num | 视频CID | 必要 | | +| ids | nums | 弹幕dmID列表 | 必要 | 多个ID之间用`,`分隔 | + +**json回复** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | --------------------------- | +| code | num | 返回值 | 0:成功
-400:请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象: + +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | ---------------- | --------------------------------- | +| {弹幕ID} | obj | 弹幕id对应的信息 | id分别对应请求参数中的`ids`,下同 | +| …… | obj | 弹幕id对应的信息 | | + +`{弹幕ID}`对象: + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ---- | -------- | ------------------------------------------------------------ | +| likes | num | 点赞数 | | +| user_like | num | 是否点赞 | 0:未点赞
1:已点赞
需要登录(Cookie或APP)
未登录恒为0 | +| id_str | str | 弹幕dmID | | + +**示例** + +查询`CID=236871317`下的弹幕`35600074482384899`、`38880975220375559`、`39052528418553863`点赞数 + +```shell +curl -G 'http://api.bilibili.com/x/v2/dm/thumbup/stats'\ +--data-urlencode 'oid=236871317'\ +--data-urlencode 'ids=39019145405661191,38880975220375559,39052528418553863'\ +-b 'SESSDATA=xxx' +``` + +
+查看响应示例: + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "38880975220375559": { + "likes": 1, + "user_like": 1, + "id_str": "38880975220375559" + }, + "39019145405661191": { + "likes": 3, + "user_like": 1, + "id_str": "39019145405661191" + }, + "39052528418553863": { + "likes": 2, + "user_like": 0, + "id_str": "39052528418553863" + } + } +} +``` + +
+ +## 点赞弹幕 + +> http://api.bilibili.com/x/v2/dm/thumbup/add + +*请求方式:POST* + +认证方式:Cookie(SESSDATA)或APP + +**正文参数( application/x-www-form-urlencoded ):** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | ------------------------ | -------------- | ------------------------ | +| access_key | str | APP登录Token | APP方式必要 | | +| dmid | num | 弹幕dmID | 必要 | | +| oid | num | 视频CID | 必要 | | +| op | num | 操作 | 必要 | 1:点赞
2:取消点赞 | +| platform | str | 平台 | 非必要 | | +| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0:成功
-101:账号未登录
-111:csrf 校验失败
-400:请求错误
65004:取消赞失败 未点赞过
65006:已赞过 | +| message | str | 错误信息 | 默认为0 | +| tll | num | 1 | | + +**示例** + +为`CID=145928946`下的弹幕`35600074482384899`点赞 + +```shell +curl 'http://api.bilibili.com/x/v2/dm/thumbup/add'\ +--data-urlencode 'dmid=35600074482384899'\ +--data-urlencode 'oid=145928946'\ +--data-urlencode 'op=1'\ +--data-urlencode 'platform=web_player'\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +``` + +
+查看响应示例: + +```json +{ + "code":0, + "message":"0", + "ttl":1 +} +``` + +
+ +## 举报弹幕 + +> http://api.bilibili.com/x/dm/report/add + +*请求方式:POST* + +认证方式:Cookie(SESSDATA)或APP + +**正文参数( application/x-www-form-urlencoded ):** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | ------------------------ | -------------- | ------------------ | +| access_key | str | APP登录Token | APP方式必要 | | +| cid | num | 视频CID | 必要 | | +| dmid | num | 弹幕dmID | 必要 | | +| reason | num | 举报类型 | 必要 | **类型代码见下表** | +| content | str | 其他举报备注 | 非必要 | `reason=11`时有效 | +| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | | + +举报类型`reason`: + +| 代码 | 含义 | +| ---- | ---------- | +| 1 | 违法违禁 | +| 2 | 色情低俗 | +| 3 | 赌博诈骗 | +| 4 | 人身攻击 | +| 5 | 侵犯隐私 | +| 6 | 垃圾广告 | +| 7 | 引战 | +| 8 | 剧透 | +| 9 | 恶意刷屏 | +| 10 | 视频无关 | +| 11 | 其他 | +| 12 | 青少年不良 | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0:成功
-101:账号未登录
-111:csrf 校验失败
-400:请求错误
36201:举报弹幕不存在
36203:举报原因类型错误
36204:已举报 | +| message | str | 错误信息 | 默认为空 | +| tll | num | 1 | 举报失败时 | + +**示例** + +举报`CID=145928946`下的弹幕`35600074482384899`,理由是`引战` + +```shell +curl 'http://api.bilibili.com/x/dm/report/add'\ +--data-urlencode 'cid=145928946'\ +--data-urlencode 'dmid=35600074482384899'\ +--data-urlencode 'reason=7'\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +``` + +
+查看响应示例: + +```json +{ + "code":0, + "message":"" +} +``` + +
diff --git a/danmaku/danmaku_xml.md b/danmaku/danmaku_xml.md index 5e8e584..e2dda95 100644 --- a/danmaku/danmaku_xml.md +++ b/danmaku/danmaku_xml.md @@ -1,6 +1,6 @@ # xml弹幕 -实时弹幕池容量有限(根据视频类型500-3000条不等),占满后再发送会使实时弹幕池底部的弹幕压入历史弹幕池(类似于堆栈) +实时弹幕池容量有限(根据视频类型500-8000条不等),占满后再发送会使实时弹幕池底部的弹幕压入历史弹幕池(类似于堆栈) ## 获取实时弹幕1