Merge remote-tracking branch 'upstream/master' into patch-1

This commit is contained in:
wuziqian211
2024-03-10 18:16:13 +08:00
147 changed files with 32789 additions and 18605 deletions

View File

@@ -1,4 +1,4 @@
# 视频点赞&投币&收藏&分享
# 稿件观众操作
## 点赞
@@ -12,24 +12,26 @@
认证方式仅可CookieSESSDATA
需验证 Cookie 中`buvid3`字段存在且正常, 否则将导致触发风控
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------------ | ---------------------- |
| aid | num | 稿件avid | 必要(可选) | avidbvid任选一个 |
| bvid | str | 稿件bvid | 必要(可选) | avidbvid任选一个 |
| like | num | 操作方式 | 必要 | 1点赞<br />2取消赞 |
| csrf | str | CSRF Token位于cookie | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------- | ------------ | ---------------------- |
| aid | num | 稿件 avid | 必要(可选) | avidbvid 任选一个 |
| bvid | str | 稿件 bvid | 必要(可选) | avidbvid 任选一个 |
| like | num | 操作方式 | 必要 | 1点赞<br />2取消赞 |
| csrf | str | CSRF Token位于 Cookie | 必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| code | num | 返回值 | 0成功 <br />-101账号未登录<br />-111csrf校验失败<br />-400请求错误<br />10003不存在该稿件<br />65004取消点赞失败<br />65006重复点赞 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功 <br />-101账号未登录<br />-111csrf校验失败<br />-400请求错误<br />-403: 账号异常<br/> 10003不存在该稿件<br />65004取消点赞失败<br />65006重复点赞 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
**示例:**
@@ -78,22 +80,22 @@ curl 'https://api.bilibili.com/x/web-interface/archive/like' \
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| aid | num | 稿件avid | 必要 | |
| like | num | 操作方式 | 必要 | 0点赞<br />1取消赞 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | -------------- | ------------ | ---------------------- |
| access_key | str | APP 登录 Token | APP 方式必要 | |
| aid | num | 稿件 avid | 必要 | |
| like | num | 操作方式 | 必要 | 0点赞<br />1取消赞 |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------------------------------------------------------- |
| code | num | 返回值 | 0成功 <br />-101账号未登录<br />-400请求错误<br />10003不存在该稿件 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 数据本体 | |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功 <br />-101账号未登录<br />-400请求错误<br />-403: 账号异常<br />10003不存在该稿件 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 数据本体 | |
`data`对象:
@@ -138,11 +140,11 @@ curl 'https://app.bilibili.com/x/v2/view/like' \
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ------------ | ------------------ |
| access_key | str | APP登录Token | APP方式必要 | |
| aid | num | 稿件avid | 必要(可选) | avidbvid任选一个 |
| bvid | str | 稿件bvid | 必要(可选) | avidbvid任选一个 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | -------------- | ------------ | --------------------- |
| access_key | str | APP 登录 Token | APP 方式必要 | |
| aid | num | 稿件 avid | 必要(可选) | avidbvid 任选一个 |
| bvid | str | 稿件 bvid | 必要(可选) | avidbvid 任选一个 |
**json回复**
@@ -170,7 +172,7 @@ curl -G 'https://api.bilibili.com/x/web-interface/archive/has/like' \
bvid方式
```shell
curl -G 'api.bilibili.com/x/web-interface/archive/has/like' \
curl -G 'https://api.bilibili.com/x/web-interface/archive/has/like' \
--data-urlencode 'bvid=BV1Bt411z799' \
-b 'SESSDATA=xxx'
```
@@ -201,11 +203,11 @@ curl -G 'api.bilibili.com/x/web-interface/archive/has/like' \
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|------------|-----|-----------|-----|-----------------|
| access_key | str | APP Token | 必要 | |
| aid | num | 视频aid | 必要 | |
| dislike | num | 操作类型 | 必要 | 0点踩<br/>1取消点踩 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | -------------- | ------ | ----------------------- |
| access_key | str | APP 登录 Token | 必要 | |
| aid | num | 视频 aid | 必要 | |
| dislike | num | 操作类型 | 必要 | 0点踩<br/>1取消点踩 |
**json回复**
@@ -250,26 +252,28 @@ curl -L -X POST 'https://app.biliapi.net/x/v2/view/dislike' \
认证方式仅可CookieSESSDATA
需验证 Cookie 中`buvid3`字段存在且正常, 否则将导致触发风控
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ----------- | ---- | ------------------------ | ------------ | --------------------------------------- |
| aid | num | 稿件avid | 必要(可选) | avidbvid任选一个 |
| bvid | str | 稿件bvid | 必要(可选) | avidbvid任选一个 |
| multiply | num | 投币数量 | 必要 | 上限为2 |
| select_like | num | 是否附加点赞 | 非必要 | 0不点赞<br />1同时点赞<br />默认为0 |
| csrf | str | CSRF Token位于cookie | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ----------- | ---- | ------------------------- | ------------ | --------------------------------------- |
| aid | num | 稿件 avid | 必要(可选) | avidbvid 任选一个 |
| bvid | str | 稿件 bvid | 必要(可选) | avidbvid 任选一个 |
| multiply | num | 投币数量 | 必要 | 上限为2 |
| select_like | num | 是否附加点赞 | 非必要 | 0不点赞<br />1同时点赞<br />默认为0 |
| csrf | str | CSRF Token位于 Cookie | 必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-102账号被封停<br />-104硬币不足<br />-111csrf校验失败<br />-400请求错误<br />10003不存在该稿件<br />34002不能给自己投币<br />34003非法的投币数量<br />34004投币间隔太短<br />34005超过投币上限 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-102账号被封停<br />-104硬币不足<br />-111csrf校验失败<br />-400请求错误<br />-403: 账号异常<br />10003不存在该稿件<br />34002不能给自己投币<br />34003非法的投币数量<br />34004投币间隔太短<br />34005超过投币上限 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
data 对象:
@@ -329,12 +333,12 @@ curl 'https://api.bilibili.com/x/web-interface/coin/add' \
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ----------- | ---- | ------------ | ----------- | --------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| aid | num | 稿件avid | 必要 | |
| multiply | num | 投币数量 | 必要 | 上限为2 |
| select_like | num | 附加点赞 | 非必要 | 0不点赞<br />1同时点赞<br />默认为0 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ----------- | ---- | -------------- | ------------ | --------------------------------------- |
| access_key | str | APP 登录 Token | APP 方式必要 | |
| aid | num | 稿件 avid | 必要 | |
| multiply | num | 投币数量 | 必要 | 上限为2 |
| select_like | num | 附加点赞 | 非必要 | 0不点赞<br />1同时点赞<br />默认为0 |
**json回复**
@@ -389,11 +393,11 @@ curl 'https://app.bilibili.com/x/v2/view/coin/add' \
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ------------ | ------------------ |
| access_key | str | APP登录Token | APP方式必要 | |
| aid | num | 稿件avid | 必要(可选) | avidbvid任选一个 |
| bvid | str | 稿件bvid | 必要(可选) | avidbvid任选一个 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | -------------- | ------------ | --------------------- |
| access_key | str | APP 登录 Token | APP方式必要 | |
| aid | num | 稿件 avid | 必要(可选) | avidbvid 任选一个 |
| bvid | str | 稿件 bvid | 必要(可选) | avidbvid 任选一个 |
**json回复**
@@ -419,7 +423,7 @@ curl 'https://app.bilibili.com/x/v2/view/coin/add' \
avid方式
```shell
curl -G 'api.bilibili.com/x/web-interface/archive/coins' \
curl -G 'https://api.bilibili.com/x/web-interface/archive/coins' \
--data-urlencode 'aid=37896701' \
-b 'SESSDATA=xxx'
```
@@ -427,7 +431,7 @@ curl -G 'api.bilibili.com/x/web-interface/archive/coins' \
bvid方式
```shell
curl -G 'api.bilibili.com/x/web-interface/archive/coins' \
curl -G 'https://api.bilibili.com/x/web-interface/archive/coins' \
--data-urlencode 'bvid=BV18t411q7zz' \
-b 'SESSDATA=xxx'
```
@@ -468,12 +472,12 @@ curl -G 'api.bilibili.com/x/web-interface/archive/coins' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------- | ---- | ------------------------ | -------------- | ------------------------------ |
| access_key | str | APP登录Token | APP方式必要 | |
| rid | num | 稿件avid | 必要 | |
| access_key | str | APP 登录 Token | APP 方式必要 | |
| rid | num | 稿件 avid | 必要 | |
| type | num | 必须为2 | 必要 | |
| add_media_ids | nums | 需要加入的收藏夹mlid | 非必要 | 同时添加多个,用`,`%2C分隔 |
| del_media_ids | nums | 需要取消的收藏夹mlid | 非必要 | 同时取消多个,用`,`%2C分隔 |
| csrf | str | CSRF Token位于cookie | Cookie方式必要 | |
| add_media_ids | nums | 需要加入的收藏夹 mlid | 非必要 | 同时添加多个,用`,`%2C分隔 |
| del_media_ids | nums | 需要取消的收藏夹 mlid | 非必要 | 同时取消多个,用`,`%2C分隔 |
| csrf | str | CSRF Token位于 Cookie | Cookie 方式必要 | |
**json回复**
@@ -544,10 +548,10 @@ curl 'https://api.bilibili.com/medialist/gateway/coll/resource/deal' \
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | -------- | ------------------ | ----------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
| aid | numstr | 稿件avid或稿件bvid | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---------- | --------------------- | ------------ | ---- |
| access_key | str | APP 登录 Token | APP 方式必要 | |
| aid | numstr | 稿件 avid 或稿件 bvid | 必要 | |
**json回复**
@@ -618,24 +622,26 @@ curl -G 'https://api.bilibili.com/x/v2/fav/video/favoured' \
同时点赞投币收藏视频,收藏于默认收藏夹中
需验证 Cookie 中`buvid3`字段存在且正常, 否则将导致触发风控
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------------ | ------------------ |
| aid | num | 稿件avid | 必要(可选) | avidbvid任选一个 |
| bvid | str | 稿件bvid | 必要(可选) | avidbvid任选一个 |
| csrf | str | CSRF Token位于cookie | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------- | ------------ | --------------------- |
| aid | num | 稿件 avid | 必要(可选) | avidbvid 任选一个 |
| bvid | str | 稿件 bvid | 必要(可选) | avidbvid 任选一个 |
| csrf | str | CSRF Token位于 Cookie | 必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | -------------------------------------------------------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-111csrf校验失败<br />-400请求错误<br />10003不存在该稿件 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- |------------------------------------------------------------------------------------------|
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-111csrf校验失败<br />-400请求错误<br />10003不存在该稿件<br />-403: 账号异常 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象:
@@ -699,10 +705,10 @@ curl 'https://api.bilibili.com/x/web-interface/archive/like/triple' \
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
| aid | num | 稿件avid | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | -------------- | ------------ | ---- |
| access_key | str | APP 登录 Token | APP 方式必要 | |
| aid | num | 稿件 avid | 必要 | |
**json回复**
@@ -761,15 +767,13 @@ curl 'https://app.bilibili.com/x/v2/view/like/triple' \
*请求方式POST*
认证方式 csrf token
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------------ | ------------------ |
| aid | num | 稿件avid | 必要(可选) | avidbvid任选一个 |
| bvid | str | 稿件bvid | 必要(可选) | avidbvid任选一个 |
| csrf | str | CSRF Token位于cookie | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------- | ------------ | --------------------- |
| aid | num | 稿件 avid | 必要(可选) | avidbvid 任选一个 |
| bvid | str | 稿件 bvid | 必要(可选) | avidbvid任 选一个 |
| csrf | str | CSRF Token位于 Cookie | 必要 | |
**json回复**

View File

@@ -17,7 +17,7 @@
| code | num | | 成功为0 |
| message | str | | 成功为0 |
| ttl | num | 1 | |
| data | List\<object> | | |
| data | array | | |
`data`数组:
@@ -40,9 +40,9 @@
| remark | str | 类型备注 | |
| ctime | str | | 意义不明 |
| mtime | str | | 意义不明 |
| controls | 拥有时:object<br>没有时null | 详细信息填写提示 | |
| controls | 拥有时:array<br>没有时null | 详细信息填写提示 | |
`data`数组中的对象中的`controls`对象:
`controls`数组中的对象:
| 项 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------------- | -------- |
@@ -61,7 +61,8 @@ curl --location --request GET 'https://api.bilibili.com/x/web-interface/archive/
```
<details>
<summary>查看响应示例</summary>
<summary>查看响应示例</summary>
```json
{
"code": 0,
@@ -74,12 +75,34 @@ curl --location --request GET 'https://api.bilibili.com/x/web-interface/archive/
"weight": 1,
"round": 2,
"state": 1,
"name": "其他问题",
"name": "其他",
"remark": "为帮助审核人员更快处理,请补充问题类型和出现位置等详细信息",
"ctime": "2018-08-13T15:41:20+08:00",
"mtime": "2018-08-13T15:41:20+08:00",
"mtime": "2023-09-21T18:40:20+08:00",
"controls": null
},
{
"tid": 8,
"business": 1,
"weight": 40,
"round": 2,
"state": 1,
"name": "与站内其他视频撞车",
"remark": "为帮助审核人员更快处理, 请描述撞车信息",
"ctime": "2018-08-13T15:41:20+08:00",
"mtime": "2023-03-06T16:36:02+08:00",
"controls": [
{
"tid": 8,
"bid": 1,
"name": "撞车对象",
"title": "撞车对象",
"component": "input",
"placeholder": "BVID",
"required": 1
}
]
},
{
"tid": 9,
"business": 1,
@@ -110,10 +133,10 @@ curl --location --request GET 'https://api.bilibili.com/x/web-interface/archive/
"weight": 35,
"round": 2,
"state": 1,
"name": "转载/自制类型错误",
"name": "转载/自制错误",
"remark": "为帮助审核人员更快处理, 请补充原创作品出处",
"ctime": "2018-08-13T15:41:20+08:00",
"mtime": "2018-08-13T15:41:20+08:00",
"mtime": "2023-09-20T16:23:39+08:00",
"controls": [
{
"tid": 52,
@@ -126,6 +149,78 @@ curl --location --request GET 'https://api.bilibili.com/x/web-interface/archive/
}
]
},
{
"tid": 10018,
"business": 1,
"weight": 36,
"round": 2,
"state": 1,
"name": "违规推广",
"remark": "",
"ctime": "2023-09-21T17:56:21+08:00",
"mtime": "2023-09-22T14:36:41+08:00",
"controls": null
},
{
"tid": 10019,
"business": 1,
"weight": 34,
"round": 2,
"state": 1,
"name": "其他不规范行为",
"remark": "",
"ctime": "2023-09-21T18:05:33+08:00",
"mtime": "2023-09-22T14:37:03+08:00",
"controls": null
},
{
"tid": 10020,
"business": 1,
"weight": 89,
"round": 2,
"state": 1,
"name": "危险行为",
"remark": "",
"ctime": "2023-09-21T18:05:51+08:00",
"mtime": "2023-09-22T14:38:08+08:00",
"controls": null
},
{
"tid": 10022,
"business": 1,
"weight": 1,
"round": 2,
"state": 1,
"name": "其他",
"remark": "",
"ctime": "2023-09-21T19:07:01+08:00",
"mtime": "2023-09-22T14:38:59+08:00",
"controls": null
},
{
"tid": 10023,
"business": 1,
"weight": 59,
"round": 2,
"state": 1,
"name": "企业商誉侵权",
"remark": "",
"ctime": "2023-12-01T14:06:58+08:00",
"mtime": "2023-12-01T15:33:26+08:00",
"controls": null
},
{
"tid": 10024,
"business": 1,
"weight": 58,
"round": 2,
"state": 1,
"name": "侵权申诉",
"remark": "",
"ctime": "2023-12-01T14:07:18+08:00",
"mtime": "2023-12-01T15:33:37+08:00",
"controls": null
},
{
"tid": 2,
"business": 1,
@@ -144,10 +239,10 @@ curl --location --request GET 'https://api.bilibili.com/x/web-interface/archive/
"weight": 90,
"round": 1,
"state": 1,
"name": "色情",
"name": "色情低俗",
"remark": "为帮助审核人员更快处理,补充违规内容出现位置",
"ctime": "2018-08-13T15:41:20+08:00",
"mtime": "2018-08-13T15:41:20+08:00",
"mtime": "2023-09-21T19:07:10+08:00",
"controls": null
},
{
@@ -198,28 +293,6 @@ curl --location --request GET 'https://api.bilibili.com/x/web-interface/archive/
"mtime": "2018-08-13T15:41:20+08:00",
"controls": null
},
{
"tid": 8,
"business": 1,
"weight": 40,
"round": 1,
"state": 1,
"name": "与站内其他视频撞车",
"remark": "为帮助审核人员更快处理, 请描述撞车信息",
"ctime": "2018-08-13T15:41:20+08:00",
"mtime": "2018-08-23T00:30:04+08:00",
"controls": [
{
"tid": 8,
"bid": 1,
"name": "撞车对象",
"title": "撞车对象",
"component": "input",
"placeholder": "BVID",
"required": 1
}
]
},
{
"tid": 10000,
"business": 1,
@@ -243,16 +316,64 @@ curl --location --request GET 'https://api.bilibili.com/x/web-interface/archive/
"ctime": "2019-04-17T19:18:09+08:00",
"mtime": "2019-04-17T20:42:25+08:00",
"controls": null
},
{
"tid": 10014,
"business": 1,
"weight": 8,
"round": 1,
"state": 1,
"name": "涉政谣言",
"remark": "为帮助审核人员更快处理,请补充谣言内容出现位置",
"ctime": "2022-09-15T17:23:44+08:00",
"mtime": "2022-09-16T09:56:07+08:00",
"controls": null
},
{
"tid": 10015,
"business": 1,
"weight": 7,
"round": 1,
"state": 1,
"name": "涉社会事件谣言",
"remark": "为帮助审核人员更快处理,请补充谣言内容出现位置",
"ctime": "2022-09-15T17:25:56+08:00",
"mtime": "2022-09-16T09:56:07+08:00",
"controls": null
},
{
"tid": 10017,
"business": 1,
"weight": 5,
"round": 1,
"state": 1,
"name": "虚假不实信息",
"remark": "为帮助审核人员更快处理,请补充不实内容出现位置",
"ctime": "2022-09-15T17:28:16+08:00",
"mtime": "2022-09-16T09:56:08+08:00",
"controls": null
},
{
"tid": 10021,
"business": 1,
"weight": 88,
"round": 1,
"state": 1,
"name": "观感不适",
"remark": "",
"ctime": "2023-09-21T18:06:15+08:00",
"mtime": "2023-09-21T18:06:15+08:00",
"controls": null
}
]
}
```
</details>
## 投诉稿件
> https://api.bilibili.com/x/web-interface/archive/appeal
> https://api.bilibili.com/x/web-interface/appeal/v2/submit
*请求方式POST*
认证方式CookieSESSDATA)
@@ -261,12 +382,15 @@ curl --location --request GET 'https://api.bilibili.com/x/web-interface/archive/
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ------------------------ |
| csrf | str | csrf token(位于cookie) | 必要 | 在url params中 |
| jsonp | str | jsonp | 必要? | 意义不明位于url params |
| csrf | str | csrf token(位于cookie bili_jct) | 必要 | 位于request body |
| aid | num | 稿件aid | 必要 | 位于request body |
| tid | num | 投诉理由tid | 必要 | 位于request body |
| desc | str | 投诉理由详细描述 | 必要 | 位于request body |
| attach | str | 附件(多个附件用逗号隔开 | 非必要 | 位于request body |
| buid | str | 风控代码 | 必要 | 位于request header |
| Buid | str | 风控代码 | 必要 | 位于request cookies |
上下两个buid值必须相同可随机
**json回复**
@@ -279,7 +403,8 @@ curl --location --request GET 'https://api.bilibili.com/x/web-interface/archive/
**示例举报av号为61080066的视频理由为人身攻击描述为“xxxxx”并附带了一个图片附件
```bash
curl --location --request POST 'https://api.bilibili.com/x/web-interface/archive/appeal?jsonp=jsonp&csrf=xxxx' \
curl --location --request POST 'https://api.bilibili.com/x/web-interface/appeal/v2/submit' \
--form 'csrf="xxxx"'\
--form 'aid="61080066"' \
--form 'tid="7"' \
--form 'desc="xxxxx"' \
@@ -288,6 +413,7 @@ curl --location --request POST 'https://api.bilibili.com/x/web-interface/archive
<details>
<summary>查看响应示例</summary>
```json
{
"code":0,
@@ -295,4 +421,5 @@ curl --location --request POST 'https://api.bilibili.com/x/web-interface/archive
"ttl":1
}
```
</details>

View File

@@ -29,7 +29,7 @@
| 18 | 是否付费 | |
| 19 | 推送动态 | |
| 20 | 家长模式 | |
| 21 | 是否限制游客和外链 | 分为两种情况默认全部网页限制referer跳转但第二种未登录无法访问可以通过未登陆b站访问http://api.bilibili.com/x/web-interface/view 返回的code为-403来判断 |
| 21 | 是否限制游客和外链 | 分为两种情况默认全部网页限制referer跳转但第二种未登录无法访问可以通过未登陆b站访问https://api.bilibili.com/x/web-interface/view 返回的code为-403来判断 |
| 22 | | |
| 23 | | |
| 24 | 是否为联合投稿 | |

92
docs/video/collection.md Normal file
View File

@@ -0,0 +1,92 @@
# 视频合集信息
## 获取视频合集信息
> https://api.bilibili.com/x/polymer/web-space/seasons_archives_list
*请求方式GET*
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|--------|-----|------|--------|-----|
| mid | num | UP 主 ID | 必要 | |
| season_id | num | 视频合集 ID | 必要 | |
| sort_reverse | bool | 未知 | 可选 | |
| page_num | num | 页码索引 | 可选 | |
| page_size | num | 单页内容数量 | 可选 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---------|-----|------|------------------------------------------------------------------------------------|
| code | num | 返回值 | 0成功 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------------------- | ------- | ------------------------------ | ----------------------------------------------------------- |
| aids | array | 稿件avid | 对应下方数组中内容 aid |
| archives | array | 合集中的视频 | |
| meta | obj | 合集元数据 | |
| page | obj | 分页信息 | |
`data`中的`archives`数组:
| 项 | 类型 | 内容 | 备注 |
|-----|-----|----------|---------|
| 0 | obj | 合集内容 | |
| n | obj | (n+1)P内容 | |
| …… | obj | …… | …… |
`archives`数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
|----------|-----|------|-----|
| aid | num | 稿件avid ||
| bvid | str | 稿件bvid ||
| ctime | num | 创建时间 | Unix 时间戳 |
| duration | num | 视频时长 | 单位为秒 |
| enable_vt | bool | false ||
| interactive_video | bool | false ||
| pic | str | 封面 URL ||
| playback_position | num || 会随着播放时间增长,播放完成后为 -1 。单位未知 |
| pubdate | num | 发布日期 | Unix 时间戳 |
| stat | obj | 稿件信息 ||
| state | num | 0 ||
| title | str | 稿件标题||
| ugc_pay | num | 0 ||
| vt_display | str |||
`archives`中的`stat`对象:
| 字段 | 类型 | 内容 | 备注 |
|----------|-----|------|-----|
| view | num | 稿件播放量 ||
| vt | num | 0 ||
`data`中的`meta`对象:
| 字段 | 类型 | 内容 | 备注 |
|-----------------|-----|--------------|--------|
| category | num | 0 | |
| covr | str | 合集封面 URL | |
| description | str | 合集描述 | |
| mid | num | UP 主 ID | |
| name | num | 合集标题 | |
| ptime | num | 发布时间 | Unix 时间戳 |
| season_id | num | 合集 ID | |
| total | num | 合集内视频数量 | |
`data`中的`page`对象:
| 字段 | 类型 | 内容 | 备注 |
|-----------------|-----|--------------|--------|
| page_num | num | 分页页码 | |
| page_size | num | 单页个数 | |
| total | num | 合集内视频数量 | |

File diff suppressed because it is too large Load Diff

View File

@@ -1,5 +1,10 @@
# 视频推荐
- [获取单视频推荐列表web端](#获取单视频推荐列表web端)
- [获取首页视频推荐列表web端](#获取首页视频推荐列表web端)
- [获取短视频模式视频列表](#获取短视频模式视频列表)
---
## 获取单视频推荐列表web端
> https://api.bilibili.com/x/web-interface/archive/related
@@ -288,3 +293,615 @@ curl -G 'https://api.bilibili.com/x/web-interface/archive/related' \
```
</details>
## 获取首页视频推荐列表web端
> https://api.bilibili.com/x/web-interface/index/top/rcmd
*请求方式GET*
认证方式CookieSESSDATA
最多获取14条推荐视频
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|--------------|-----|---------------------------|-----|------------------------------|
| fresh_type | num | 相关性 | 非必要 | 默认为3 <br /> 值越大推荐内容越相关 |
| version | num | web端新旧版本:0为旧版本1为新版本 | 非必要 | 默认为0 <br /> 1,0分别为新旧web端 |
| ps | num | pagesize 单页返回的记录条数默认为10或8 | 非必要 | 默认为10 <br /> 当version为1时默认为8 |
| fresh_idx | num | 翻页相关 | 非必要 | 默认为1 <br /> 与翻页相关 |
| fresh_idx_1h | num | 翻页相关 | 非必要 | 默认为1 <br /> 与翻页相关 |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
|-------------|-------|------|----------------------|
| code | num | 返回值 | 0成功 <br />-400请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | array | 推荐列表 | |
| userfeature | str | 用户功能 | |
| abtest | obj | 用户分组 | |
`data`数组:
| 项 | 类型 | 内容 | 备注 |
|-----| ---- |-----------| ---- |
| 0 | obj | 推荐视频1 | |
| n | obj | 推荐视频(n+1) | |
| …… | obj | …… | …… |
| 13 | obj | 推荐视频13 | |
`data`数组中的对象:
基本同「[获取视频详细信息web端](info.md#获取视频详细信息web端)」中的data对象
`abtest`对象:
| 字段 | 类型 | 内容 | 备注 |
|-------|-----|------|-----|
| group | str | 用户分组 | |
**示例:**
获取新版web端首页推荐视频列表
```shell
curl -G 'https://api.bilibili.com/x/web-interface/index/top/rcmd' \
--data-urlencode 'fresh_type=3' \
--data-urlencode 'version=1' \
--data-urlencode 'ps=10' \
--data-urlencode 'fresh_idx=1' \
--data-urlencode 'fresh_idx_1h=1'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"item": [
{
"id": 511495739,
"bvid": "BV1Cu411z7mG",
"cid": 717978243,
"goto": "av",
"uri": "http://www.bilibili.com/video/BV1Cu411z7mG",
"pic": "http://i2.hdslb.com/bfs/archive/e05f487bc9f26baa568f10fe69a0e1ea5e0fbc23.jpg",
"title": "请大家助力我的梦想为凑够10万赞在街头唱《Be Crazy For Me》",
"duration": 199,
"pubdate": 1652605500,
"owner": {
"mid": 1723817,
"name": "樱萍Apple",
"face": "http://i2.hdslb.com/bfs/face/6e0fa1bdbbf7e0dd929d968df3b57ca99d187e25.jpg"
},
"stat": {
"view": 263169,
"like": 39871,
"danmaku": 543
},
"avfeature": "{\"ctr\":0.192554,\"wdur\":2.323159,\"duration\":213.318313,\"wdlks\":0.685926,\"multi_score_0\":0.452564,\"multi_score_1\":0.112414,\"multi_score_2\":0.03976,\"rankscore\":13.906487,\"av_play\":258890,\"av_like\":39224,\"av_coin\":7165,\"reason_type\":3,\"av_feature\":\"|real_matchtype -1 |s_e online_av2av_v2 |source_len 1 |m_k_w 0 \"}",
"isfollowed": 0,
"rcmdreason": {
"content": "3万点赞",
"reasontype": 3
},
"showinfo": 1,
"trackid": "web_pegasus_0.shylf-ai-recsys-1355.165525355529.398"
}
......
],
"userfeature": "{\"enter_rank\":1500,\"is_fallback\":0,\"s_fresh_idx\":41,\"s_fresh_idx_session\":31,\"s_session_idx\":1,\"fresh_idx\":1,\"fresh_idx_1h\":1}",
"abtest": {
"group": "b"
}
}
}
```
</details>
## 获取短视频模式视频列表
> https://app.bilibili.com/x/v2/feed/index
*请求方式GET*
认证方式CookieSESSDATA
**url参数**
有大量不明意义的参数 备注仅供参考
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|--------------|-----|---------------------------|-----|------------------------------|
| fnval | num | 视频流格式标识 | 非必要 | 默认为272 |
| fnver | num | 视频流版本标识 | 非必要 | 恒为1 |
| force_host | num | 源url类型 | 非必要 | 0:无限制 1:使用http 2:使用https |
| fourk | num | 是否允许 4K 视频 | 非必要 | 画质最高 1080P0默认<br />画质最高 4K1 |
| guidance | num | 0 | 非必要 | |
| https_url_req | num | 0 | 非必要 | |
| inline_danmu | num | 2 | 非必要 | |
| inline_sound | num | 1 | 非必要 | |
| interest_id | num | 0 | 非必要 | |
| login_event | num | 登录状态 | 非必要 | 0为登录 1为未登录 |
| mobi_app | num | android | 非必要 | 设备类型 |
| network | num | wifi | 非必要 | 网络类型 |
| open_event | num | | 非必要 | |
| platform | num | android | 非必要 | 设备类型 |
| pull | boll | false | 非必要 | |
| qn | num | 32 | 非必要 | 似乎是画质 |
| recsys_mode | num | 0 | 非必要 | |
| s_locale | str | zh_CN | 非必要 | 语言 |
| video_mode | num | 1 | 非必要 | |
| voice_balance | num | 音量均衡? | 非必要 | 默认为1 |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
|-------------|-------|------|----------------------|
| code | num | 返回值 | 0成功 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
|-------------|-------|------|----------------------|
| config | obj | 一些界面相关的内容 | 此处省略 |
| items | array | 视频列表 | |
`data`中的`items`数组的对象:
以下为视频类型
| 字段 | 类型 | 内容 | 备注 |
|-------------|-------|------|----------------------|
| can_play | num | 1 | 字面意思 |
| card_goto | str | av | |
| card_type | str | 卡片类型 | 视频为small_cover_v2 |
| cover | str | 封面url | |
| cover_left_1_content_description | str | 播放量 | 8.9万观看 |
| cover_left_2_content_description | str | 弹幕数 | 250弹幕 |
| cover_left_text_1 | str | 播放量 | 8.9万 |
| cover_left_text_2 | str | 弹幕数 | 250 |
| cover_right_content_description | str | 视频长度 | 1分钟20秒 |
| cover_right_text | str | 视频长度 | 1:20 |
| desc_button | obj | up主信息 | |
| param | str | 视频aid | |
| player_args | obj | 视频信息 | |
| talk_back | str | | |
| title | str | 标题 | |
| uri | str | 跳转链接 | |
`desc_button`对象:
| 字段 | 类型 | 内容 | 备注 |
|-------------|-------|------|----------------------|
| event | str | | |
| text | str | up名称 | |
| type | num | 1 | |
| uri | str | 跳转链接 | |
`player_args`对象:
| 字段 | 类型 | 内容 | 备注 |
|-------------|-------|------|----------------------|
| aid | num | 视频aid | |
| cid | num | 视频cid | |
| duration | num | 视频长度 | 秒数 |
| type | str | | |
**示例:**
获取短视频模式视频列表
```shell
curl -G 'https://app.bilibili.com/x/v2/feed/index'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"items": [
{
"card_type": "small_cover_v2",
"card_goto": "av",
"goto": "av",
"param": "411978753",
"cover": "http://i2.hdslb.com/bfs/archive/a1bda1e57e6812ca8822a8839fc4a1d3539255a8.jpg",
"title": "帕 鲁 现 状",
"uri": "bilibili://video/411978753?cid=1423365216\u0026player_height=1920\u0026player_preload=%7B%22cid%22%3A1423365216%2C%22expire_time%22%3A1706633200%2C%22file_info%22%3A%7B%2216%22%3A%5B%7B%22timelength%22%3A79970%2C%22filesize%22%3A3782665%7D%5D%2C%2264%22%3A%5B%7B%22timelength%22%3A79900%2C%22filesize%22%3A9552030%7D%5D%7D%2C%22support_quality%22%3Anull%2C%22support_formats%22%3Anull%2C%22support_description%22%3Anull%2C%22quality%22%3A16%2C%22url%22%3A%22http%3A%2F%2Fcn-gdst-cm-01-12.bilivideo.com%2Fupgcxcode%2F16%2F52%2F1423365216%2F1423365216-1-16.mp4%3Fe%3Dig8euxZM2rNcNbRVhwdVhwdlhWdVhwdVhoNvNC8BqJIzNbfqXBvEuENvNC8aNEVEtEvE9IMvXBvE2ENvNCImNEVEIj0Y2J_aug859r1qXg8gNEVE5XREto8z5JZC2X2gkX5L5F1eTX1jkXlsTXHeux_f2o859IB_%5Cu0026uipk%3D5%5Cu0026nbs%3D1%5Cu0026deadline%3D1706636800%5Cu0026gen%3Dplayurlv2%5Cu0026os%3Dbcache%5Cu0026oi%3D0%5Cu0026trid%3D00000ccc07d4b7a34140a25493d51003bd95U%5Cu0026mid%3D0%5Cu0026platform%3D%5Cu0026upsig%3D2bf8e99202a181300981ab6ba9d2305d%5Cu0026uparams%3De%2Cuipk%2Cnbs%2Cdeadline%2Cgen%2Cos%2Coi%2Ctrid%2Cmid%2Cplatform%5Cu0026cdnid%3D6876%5Cu0026bvc%3Dvod%5Cu0026nettype%3D0%5Cu0026orderid%3D0%2C3%5Cu0026buvid%3D%5Cu0026build%3D0%5Cu0026f%3DU_0_0%5Cu0026bw%3D47881%5Cu0026logo%3D80000000%22%2C%22video_codecid%22%3A7%2C%22video_project%22%3Atrue%2C%22fnver%22%3A0%2C%22fnval%22%3A0%7D\u0026player_rotate=0\u0026player_width=1080\u0026report_flow_data=%7B%22flow_card_type%22%3A%22av%22%7D",
"three_point": {
"dislike_reasons": [
{
"id": 4,
"name": "UP主:锤子game",
"toast": "将减少相似内容推荐"
},
{
"id": 2,
"name": "分区:网络游戏",
"toast": "将减少相似内容推荐"
},
{
"id": 3,
"name": "频道:搞笑",
"toast": "将减少相似内容推荐"
},
{
"id": 12,
"name": "此类内容过多",
"toast": "将减少相似内容推荐"
},
{
"id": 13,
"name": "推荐过",
"toast": "将减少相似内容推荐"
},
{
"id": 1,
"name": "不感兴趣",
"toast": "将减少相似内容推荐"
}
],
"feedbacks": [
{
"id": 1,
"name": "恐怖血腥",
"toast": "将优化首页此类内容"
},
{
"id": 2,
"name": "色情低俗",
"toast": "将优化首页此类内容"
},
{
"id": 3,
"name": "封面恶心",
"toast": "将优化首页此类内容"
},
{
"id": 4,
"name": "标题党/封面党",
"toast": "将优化首页此类内容"
}
],
"watch_later": 1
},
"args": {
"up_id": 495695169,
"up_name": "锤子game",
"rid": 65,
"rname": "网络游戏",
"tid": 1833,
"tname": "搞笑",
"aid": 411978753
},
"player_args": {
"aid": 411978753,
"cid": 1423365216,
"type": "av",
"duration": 80
},
"idx": 1706629610,
"three_point_v2": [
{
"title": "添加至稍后再看",
"type": "watch_later",
"icon": "https://i0.hdslb.com/bfs/activity-plat/static/ce06d65bc0a8d8aa2a463747ce2a4752/NyPAqcn0QF.png"
},
{
"title": "反馈",
"subtitle": "(选择后将优化首页此类内容)",
"reasons": [
{
"id": 1,
"name": "恐怖血腥",
"toast": "将优化首页此类内容"
},
{
"id": 2,
"name": "色情低俗",
"toast": "将优化首页此类内容"
},
{
"id": 3,
"name": "封面恶心",
"toast": "将优化首页此类内容"
},
{
"id": 4,
"name": "标题党/封面党",
"toast": "将优化首页此类内容"
}
],
"type": "feedback"
},
{
"title": "不感兴趣",
"subtitle": "(选择后将减少相似内容推荐)",
"reasons": [
{
"id": 4,
"name": "UP主:锤子game",
"toast": "将减少相似内容推荐"
},
{
"id": 2,
"name": "分区:网络游戏",
"toast": "将减少相似内容推荐"
},
{
"id": 3,
"name": "频道:搞笑",
"toast": "将减少相似内容推荐"
},
{
"id": 12,
"name": "此类内容过多",
"toast": "将减少相似内容推荐"
},
{
"id": 13,
"name": "推荐过",
"toast": "将减少相似内容推荐"
},
{
"id": 1,
"name": "不感兴趣",
"toast": "将减少相似内容推荐"
}
],
"type": "dislike"
}
],
"talk_back": "视频,帕 鲁 现 状,32.5万观看,257弹幕,时长1分钟20秒,UP主锤子game,",
"report_flow_data": "{\"flow_card_type\":\"av\"}",
"cover_left_text_1": "32.5万",
"cover_left_icon_1": 1,
"cover_left_1_content_description": "32.5万观看",
"cover_left_text_2": "257",
"cover_left_icon_2": 3,
"cover_left_2_content_description": "257弹幕",
"cover_right_text": "1:20",
"cover_right_content_description": "1分钟20秒",
"desc_button": {
"text": "锤子game",
"uri": "bilibili://space/495695169",
"event": "nickname",
"type": 1
},
"official_icon": 16,
"can_play": 1,
"goto_icon": {
"icon_url": "https://i0.hdslb.com/bfs/activity-plat/static/20230227/0977767b2e79d8ad0a36a731068a83d7/077GOeHOfO.png",
"icon_night_url": "https://i0.hdslb.com/bfs/activity-plat/static/20230227/0977767b2e79d8ad0a36a731068a83d7/ldbCXtkoK2.png",
"icon_width": 16,
"icon_height": 16
}
},
{
"card_type": "small_cover_v2",
"card_goto": "av",
"goto": "av",
"param": "836990443",
"cover": "http://i1.hdslb.com/bfs/archive/d16a125d6ec1c68cc9e0815bc28dcb62a1df9932.jpg",
"title": "【Phigros自制/崩坏:星穹铁道】欢迎来到匹诺康尼! 不眠之夜 IN Lv.13",
"uri": "bilibili://video/836990443?cid=1422516399\u0026player_height=1080\u0026player_preload=%7B%22cid%22%3A1422516399%2C%22expire_time%22%3A1706633200%2C%22file_info%22%3A%7B%2216%22%3A%5B%7B%22timelength%22%3A102818%2C%22filesize%22%3A4441802%7D%5D%2C%2264%22%3A%5B%7B%22timelength%22%3A102748%2C%22filesize%22%3A12468618%7D%5D%7D%2C%22support_quality%22%3Anull%2C%22support_formats%22%3Anull%2C%22support_description%22%3Anull%2C%22quality%22%3A16%2C%22url%22%3A%22http%3A%2F%2Fupos-sz-mirrorali.bilivideo.com%2Fupgcxcode%2F99%2F63%2F1422516399%2F1422516399-1-16.mp4%3Fe%3Dig8euxZM2rNcNbRVhwdVhwdlhWdVhwdVhoNvNC8BqJIzNbfqXBvEuENvNC8aNEVEtEvE9IMvXBvE2ENvNCImNEVEIj0Y2J_aug859r1qXg8gNEVE5XREto8z5JZC2X2gkX5L5F1eTX1jkXlsTXHeux_f2o859IB_%5Cu0026uipk%3D5%5Cu0026nbs%3D1%5Cu0026deadline%3D1706636800%5Cu0026gen%3Dplayurlv2%5Cu0026os%3Dalibv%5Cu0026oi%3D0%5Cu0026trid%3D0ccc07d4b7a34140a25493d51003bd95U%5Cu0026mid%3D0%5Cu0026platform%3D%5Cu0026upsig%3D06ea793aa573018646c0096adf0dcb9e%5Cu0026uparams%3De%2Cuipk%2Cnbs%2Cdeadline%2Cgen%2Cos%2Coi%2Ctrid%2Cmid%2Cplatform%5Cu0026bvc%3Dvod%5Cu0026nettype%3D0%5Cu0026orderid%3D0%2C3%5Cu0026buvid%3D%5Cu0026build%3D0%5Cu0026f%3DU_0_0%5Cu0026bw%3D43547%5Cu0026logo%3D80000000%22%2C%22video_codecid%22%3A7%2C%22video_project%22%3Atrue%2C%22fnver%22%3A0%2C%22fnval%22%3A0%7D\u0026player_rotate=0\u0026player_width=1920\u0026report_flow_data=%7B%22flow_card_type%22%3A%22av%22%7D",
"three_point": {
"dislike_reasons": [
{
"id": 4,
"name": "UP主:早期陈总",
"toast": "将减少相似内容推荐"
},
{
"id": 2,
"name": "分区:音游",
"toast": "将减少相似内容推荐"
},
{
"id": 3,
"name": "频道:音乐游戏",
"toast": "将减少相似内容推荐"
},
{
"id": 12,
"name": "此类内容过多",
"toast": "将减少相似内容推荐"
},
{
"id": 13,
"name": "推荐过",
"toast": "将减少相似内容推荐"
},
{
"id": 1,
"name": "不感兴趣",
"toast": "将减少相似内容推荐"
}
],
"feedbacks": [
{
"id": 1,
"name": "恐怖血腥",
"toast": "将优化首页此类内容"
},
{
"id": 2,
"name": "色情低俗",
"toast": "将优化首页此类内容"
},
{
"id": 3,
"name": "封面恶心",
"toast": "将优化首页此类内容"
},
{
"id": 4,
"name": "标题党/封面党",
"toast": "将优化首页此类内容"
}
],
"watch_later": 1
},
"args": {
"up_id": 1515475415,
"up_name": "早期陈总",
"rid": 136,
"rname": "音游",
"tid": 10174,
"tname": "音乐游戏",
"aid": 836990443
},
"player_args": {
"aid": 836990443,
"cid": 1422516399,
"type": "av",
"duration": 103
},
"idx": 1706629609,
"three_point_v2": [
{
"title": "添加至稍后再看",
"type": "watch_later",
"icon": "https://i0.hdslb.com/bfs/activity-plat/static/ce06d65bc0a8d8aa2a463747ce2a4752/NyPAqcn0QF.png"
},
{
"title": "反馈",
"subtitle": "(选择后将优化首页此类内容)",
"reasons": [
{
"id": 1,
"name": "恐怖血腥",
"toast": "将优化首页此类内容"
},
{
"id": 2,
"name": "色情低俗",
"toast": "将优化首页此类内容"
},
{
"id": 3,
"name": "封面恶心",
"toast": "将优化首页此类内容"
},
{
"id": 4,
"name": "标题党/封面党",
"toast": "将优化首页此类内容"
}
],
"type": "feedback"
},
{
"title": "不感兴趣",
"subtitle": "(选择后将减少相似内容推荐)",
"reasons": [
{
"id": 4,
"name": "UP主:早期陈总",
"toast": "将减少相似内容推荐"
},
{
"id": 2,
"name": "分区:音游",
"toast": "将减少相似内容推荐"
},
{
"id": 3,
"name": "频道:音乐游戏",
"toast": "将减少相似内容推荐"
},
{
"id": 12,
"name": "此类内容过多",
"toast": "将减少相似内容推荐"
},
{
"id": 13,
"name": "推荐过",
"toast": "将减少相似内容推荐"
},
{
"id": 1,
"name": "不感兴趣",
"toast": "将减少相似内容推荐"
}
],
"type": "dislike"
}
],
"talk_back": "视频,【Phigros自制/崩坏:星穹铁道】欢迎来到匹诺康尼! 不眠之夜 IN Lv.13,22.8万观看,797弹幕,时长1分钟43秒,UP主早期陈总,",
"report_flow_data": "{\"flow_card_type\":\"av\"}",
"cover_left_text_1": "22.8万",
"cover_left_icon_1": 1,
"cover_left_1_content_description": "22.8万观看",
"cover_left_text_2": "797",
"cover_left_icon_2": 3,
"cover_left_2_content_description": "797弹幕",
"cover_right_text": "1:43",
"cover_right_content_description": "1分钟43秒",
"desc_button": {
"text": "早期陈总",
"uri": "bilibili://space/1515475415",
"event": "nickname",
"type": 1
},
"can_play": 1,
"goto_icon": {
"icon_url": "https://i0.hdslb.com/bfs/activity-plat/static/20230227/0977767b2e79d8ad0a36a731068a83d7/077GOeHOfO.png",
"icon_night_url": "https://i0.hdslb.com/bfs/activity-plat/static/20230227/0977767b2e79d8ad0a36a731068a83d7/ldbCXtkoK2.png",
"icon_width": 16,
"icon_height": 16
}
}
],
"config": {
"column": 2,
"autoplay_card": 2,
"feed_clean_abtest": 0,
"home_transfer_test": 0,
"auto_refresh_time": 1200,
"show_inline_danmaku": 1,
"toast": {},
"is_back_to_homepage": true,
"enable_rcmd_guide": true,
"inline_sound": 2,
"auto_refresh_time_by_appear": 1200,
"auto_refresh_time_by_active": 1200,
"visible_area": 80,
"card_density_exp": 1,
"story_mode_v2_guide_exp": 6
},
"interest_choose": null
}
}
```
</details>

View File

@@ -116,7 +116,7 @@ curl 'https://api.bilibili.com/x/v2/history/report' \
上报一次视频`av2`/`BV1xx411c7mD`的心跳数据
```shell
curl 'api.bilibili.com/x/click-interface/web/heartbeat' \
curl 'https://api.bilibili.com/x/click-interface/web/heartbeat' \
--data-urlencode 'aid=2' \
--data-urlencode 'bvid=BV1xx411c7mD' \
--data-urlencode 'cid=62131' \

225
docs/video/summary.md Normal file
View File

@@ -0,0 +1,225 @@
# 视频AI总结
<img src="../../assets/img/aiSummary.svg" width="100" height="100"/>
## 获取AI总结内容
> https://api.bilibili.com/x/web-interface/view/conclusion/get
*请求方式: GET*
鉴权方式:[Wbi 签名](../misc/sign/wbi.md)
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|--------|-----|--------|-----|----------------------------------|
| aid | num | 稿件 avid | 必要(可选) | avid与bvid任选一个 |
| bvid | str | 稿件 bvid | 必要(可选) | avid与bvid任选一个 |
| cid | num | 视频 cid | 必要 | |
| up_mid | num | UP主 mid | 必要 | |
| w_rid | str | Wbi 签名 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
| wts | num | 当前时间戳 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---------|-----|------|--------------------------|
| code | num | 返回值 | 0: 成功<br />-400请求错误<br /> -403: 访问权限不足 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 数据本体 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
|--------------|-----|------|----------------------|
| code | num | 返回值 | -1: 不支持AI摘要敏感内容等或其他因素导致请求异常<br />0: 有摘要<br />1无摘要未识别到语音 |
| model_result | obj | 摘要内容 | |
| stid | str | 摘要 id | 如`code=1`且该字段为`0`时,则未进行 AI 总结,即添加总结队列<br />`code=1`且该字段为空时未识别到语音 |
| status | num | (?) | |
| like_num | num | 点赞数 | 默认为`0` |
| dislike_num | num | 点踩数 | 默认为`0` |
`data`中的`model_result`对象:
| 字段 | 类型 | 内容 | 备注 |
|-------------|-----|----------|------------------------------------------|
| result_type | num | 数据类型 | 0: 没有摘要<br />1仅存着摘要总结<br />2存着摘要以及提纲 |
| summary | str | 视频摘要 | 通常为一段概括整个视频内容的文本 |
| outline | 有数据时array<br />无数据时null | 分段提纲 | 通常为视频中叙述的各部分及其要点 |
`model_result`对象中的`outline`数组:
| 项 | 类型 | 内容 | 备注 |
|-----|-----|---------|-----|
| 0 | obj | 总结分段1 | |
| n | obj | 总结分段(n+1) | |
| …… | obj | …… | …… |
`outline`数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
|--------------|-----|------|----|
| title | str | 分段标题 | 段落内容的概括 |
| part_outline | array | 分段要点 | 当前分段中多个提到的细节 |
| timestamp | num | 分段起始时间 | 单位为秒 |
`outline`数组中的对象中的`part_outline`数组:
| 项 | 类型 | 内容 | 备注 |
|-----|-----|---------|-----|
| 0 | obj | 分段要点1 | |
| n | obj | 分段要点(n+1) | |
| …… | obj | …… | …… |
`part_outline`数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
|-----------|-----|-------|----|
| timestamp | num | 要点起始时间 | 单位为秒 |
| content | str | 小结内容 | 其中一个分段的要点 |
**示例:**
得到视频`BV1L94y1H7CV``cid=1335073288`)的摘要
```bash
curl -G 'https://api.bilibili.com/x/web-interface/view/conclusion/get' \
--data-urlencode 'bvid=BV1L94y1H7CV' \
--data-urlencode 'cid=1335073288' \
--data-urlencode 'up_mid=297242063' \
--data-urlencode 'wts=1701546363' \
--data-urlencode 'w_rid=1073871926b3ccd99bd790f0162af634'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"code": 0,
"model_result": {
"result_type": 2,
"summary": "在网上阅读时遇到错别字和语言梗的烦恼,以及正确使用语言的重要性。作者认为,我们每个人都应该有包容心,不掉渣,不纠正别人的错误,同时也需要明辨是非,规范使用语言。视频还提到了一些常见的语言梗和错误用法,呼吁大家不要过分使用网络词汇,而应该注重语言的艺术性和深度。最后,作者欢迎大家关注他的微信公众号。",
"outline": [
{
"title": "现代人使用中文时面临的困境,包括错别字、用法不正确等问题,并呼吁大家规范使用中文。",
"part_outline": [
{
"timestamp": 1,
"content": "网友评论有错别字,勉强能看懂,但难受。"
},
{
"timestamp": 39,
"content": "重来一次,明辨是非。"
},
{
"timestamp": 167,
"content": "粉墨登场是贬义词,形容坏人打扮好老登场。"
}
],
"timestamp": 1
},
{
"title": "网络词汇的过度使用导致语言生硬,以及对流行语言梗的短暂使用感到厌倦。",
"part_outline": [
{
"timestamp": 241,
"content": "网络词汇过分使用会误导别人,使规范词汇生硬"
},
{
"timestamp": 270,
"content": "以前的语言梗有深度,现在的流行梗很短命"
},
{
"timestamp": 338,
"content": "巨星之间需要化学反应的过程,前几场发挥欠佳"
}
],
"timestamp": 241
}
]
},
"stid": "5117037934391059183",
"status": 0,
"like_num": 6,
"dislike_num": 2
}
}
```
</details>
## 点赞&点踩摘要
> https://api.bilibili.com/x/web-interface/view/conclusion/set
*请求方式POST*
认证方式Cookie(SESSDATA)
鉴权方式:[Wbi 签名](../misc/sign/wbi.md)
**url参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|-------|-----|--------|-----|----------------------------------|
| w_rid | str | Wbi 签名 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
| wts | num | 当前时间戳 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
**正文参数( application/x-www-form-urlencoded ):**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|------------|-----|----------------------|-----|-----------------------------|
| aid | num | 稿件 avid | 必要(可选) | avid与bvid任选一个 |
| bvid | str | 稿件 bvid | 必要(可选) | avid与bvid任选一个 |
| cid | num | 稿件 cid | 必要 | |
| up_mid | num | UP主 mid | 非必要 | |
| stid | num | 摘要 id | 必要 | |
| like_state | num | 执行操作 | 必要 | 1: 点赞<br />2: 取消点赞<br />3: 点踩<br />4: 取消点踩 |
| csrf | str | CSRF Token位于cookie | 必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---------|-----|------|------------------------------------------|
| code | num | 返回值 | 0: 成功 <br />-400: 请求错误<br />65002origin id 错误<br />65004取消赞失败 未点赞过<br />65005取消踩失败 未点踩过<br />65006: 已赞过<br /> 65007已踩过 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
**示例:**
为视频`BV1L94y1H7CV``cid=1335073288`)的摘要点赞
```shell
curl 'https://api.bilibili.com/x/web-interface/view/conclusion/set?w_rid=edb471fc926646ef3889a80488166b66&wts=1700358953' \
--data-urlencode 'bvid=BV1L94y1H7CV' \
--data-urlencode 'cid=1335073288' \
--data-urlencode 'up_mid=297242063' \
--data-urlencode 'stid=5117037934391059183' \
--data-urlencode '&like_state=1' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
</details>

View File

@@ -175,6 +175,7 @@
| 手工 | handmake | 161 | 手工制品的制作过程或成品展示、教程、测评类视频 | [/v/life/handmake](https://www.bilibili.com/v/life/handmake) |
| 绘画 | painting | 162 | 绘画过程或绘画教程,以及绘画相关的所有视频 | [/v/life/painting](https://www.bilibili.com/v/life/painting) |
| 日常 | daily | 21 | 记录日常生活,分享生活故事 | [/v/life/daily](https://www.bilibili.com/v/life/daily) |
| 亲子 |parenting | 254 | 分享亲子、萌娃、母婴、育儿相关的视频 | [/v/life/parenting](https://www.bilibili.com/v/life/parenting)|
| ~~美食圈~~(重定向) | ~~food~~ | ~~76~~ | ~~美食鉴赏&料理制作教程~~ | ~~/v/life/food~~ |
| ~~动物圈~~(重定向) | ~~animal~~ | ~~75~~ | ~~萌萌的动物都在这里哦~~ | ~~/v/life/animal~~ |
| ~~运动~~(重定向) | ~~sports~~ | ~~163~~ | ~~运动相关的记录、教程、装备评测和精彩瞬间剪辑视频~~ | ~~/v/life/sports~~ |

View File

@@ -69,12 +69,16 @@
## 获取视频流地址_web端
> https://api.bilibili.com/x/player/playurl
> https://api.bilibili.com/x/player/wbi/playurl
> ~~https://api.bilibili.com/x/player/playurl~~ (旧链接)
*请求方式GET*
认证方式CookieSESSDATA
鉴权方式:[Wbi 签名](../misc/sign/wbi.md)
---
关于视频流会员鉴权:
@@ -109,7 +113,8 @@
| session | str | | 非必要 | 从视频播放页的 HTML 中获取 |
| otype | str | | 非必要 | 固定为`json` |
| type | str | | 非必要 | 目前为空 |
| platform | str | | 非必要 | pcweb播放默认值视频流存在 referer鉴权<br />html5移动端 HTML5 播放(仅支持 MP4 格式,清晰度最高 360P无 referer 鉴权可以直接使用`video`标签播放) |
| platform | str | | 非必要 | pcweb播放默认值视频流存在 referer鉴权<br />html5移动端 HTML5 播放(仅支持 MP4 格式,无 referer 鉴权可以直接使用`video`标签播放) |
| high_quality | num | 是否高画质 | 非必要 | platform=html5时此值为1可使画质为1080p |
**json回复**
@@ -452,9 +457,9 @@ curl -G 'https://api.bilibili.com/x/player/playurl' \
| minBufferTime | num | 1.5 | |
| min_buffer_time | num | 1.5 | |
| video | array | 视频流信息 | |
| audio | array | 伴音流信息 | |
| audio | array | 伴音流信息 | 当视频没有音轨时,此项为 null |
| dolby | obj | 杜比全景声伴音信息 | |
| flac | obj | 无损音轨伴音信息 | |
| flac | obj | 无损音轨伴音信息 | 当视频没有无损音轨时,此项为 null |
`dash`中的`video`数组:
@@ -494,7 +499,7 @@ curl -G 'https://api.bilibili.com/x/player/playurl' \
| start_with_sap | num | **同上** | |
| SegmentBase | obj | 见下表 | url 对应 m4s 文件中,头部的位置<br />音频流该值恒为空 |
| segment_base | obj | **同上** | |
| codecid | num | 码流编码标识代码 | 含义见 [上表](视频编码代码)<br />音频流该值恒为`0` |
| codecid | num | 码流编码标识代码 | 含义见 [上表](#视频编码代码)<br />音频流该值恒为`0` |
`video`数组中的对象中的`backup_url`数组: