Compare commits

..

3 Commits

Author SHA1 Message Date
watermelon
8b3532b442 feat/增加 b23.tv 短链类型 (#1440)
* feat: update b23.tv short link type

* feat: add share_origin choices

* feat: add opus type

same as dynamic
2026-01-12 02:55:45 +08:00
Sheep-realms
bae574a1a9 更改一些视频相关字段的描述 (#1432)
* Update is_story and is_story_play descriptions

* Clarify 'is_self_view' field description

Updated the description for the 'is_self_view' field to clarify its purpose.

* Update is_view_self description in info.md

* Add new copyright type to video info documentation

* Update copyright field options in space.md

* Update copyright field options in history.md

* Update copyright field options in toview.md
2026-01-12 02:54:42 +08:00
huanli233
0bf5dd275a feat: Revise features parameter and add fallback details (#1429)
Updated the description of the 'features' parameter and added fallback object details.
2026-01-12 02:54:12 +08:00
6 changed files with 50 additions and 26 deletions

View File

@@ -387,7 +387,7 @@ curl -G 'https://api.bilibili.com/x/web-interface/history/cursor' \
| videos | num | 视频分P总数 | 默认为1 |
| tid | num | 分区tid | |
| tname | str | 子分区名称 | |
| copyright | num | 是否转载 | 1原创<br />2转载 |
| copyright | num | 是否转载 | 1原创<br />2转载<br />3未填写 |
| pic | str | 视频封面图片url | |
| title | str | 稿件标题 | |
| pubdate | num | 稿件发布时间 | 时间戳 |

View File

@@ -164,7 +164,7 @@ curl 'https://space.bilibili.com/ajax/channel/addAllToView' \
| videos | num | 稿件分P总数 | 默认为1 |
| tid | num | 分区tid | |
| tname | str | 子分区名称 | |
| copyright | num | 是否转载 | 1原创<br />2转载 |
| copyright | num | 是否转载 | 1原创<br />2转载<br />3未填写 |
| pic | str | 稿件封面图片url | |
| title | str | 稿件标题 | |
| pubdate | num | 稿件发布时间 | 时间戳 |

View File

@@ -37,7 +37,7 @@ b23.tv 是由 Bilibili 提供的短链服务, 主要用于站内长链接缩短
必要:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------- | ------ | ---- |
| buvid | str | 设备 BUVID | 必要 | 实际任意非空字符串即可 |
| build | num | 客户端版本号 | 必要 | 大于 `5520400` 的任意有效整数, 如 `7710300` |
@@ -45,6 +45,7 @@ b23.tv 是由 Bilibili 提供的短链服务, 主要用于站内长链接缩短
| share_channel | str | 分享方式? | 必要 | COPY |
| share_mode | num | 分享模式? | 必要 | 任意有效正整数, 常见 `1`, `3`, `4` |
| share_id | str | 分享 ID | 必要 | 见下方对照表 |
| share_origin | str | 分享来源? | 部分必要 | 见下方对照表 |
| oid | num | 对象 ID | 必要 | 见下方对照表 |
不必要:
@@ -55,26 +56,25 @@ b23.tv 是由 Bilibili 提供的短链服务, 主要用于站内长链接缩短
| panel_type | num | 面板类型? | 非必要 | 1 |
| share_title | str | 分享标题? | 非必要 | 分享标题 |
| share_content | str | 分享内容? | 非必要 | 分享内容, 当 oid 存在时无意义<s>(可是 oid 不可能不存在啊)</s> |
| share_origin | str | 分享来源? | 非必要 | 如 `vinfo_share` `dynamic` `vertical-three-point-panel` `vinfo_player` |
| share_pattern | num | 分享模式? | 非必要 | 0 |
| share_session_id | str | 分享会话 ID? | 非必要 | 各部分用 `-` 分隔的小写的一串 UUID |
| ts | num | UNIX 秒级时间戳 | 非必要 | |
对照表:
| 类型 | 分享 ID (share_id) | 对象 ID (oid) |
| --- | ------------------ | ------------- |
| 视频 | main.ugc-video-detail.0.0.pv | 视频 aid |
<!-- 此处被注释是因为以下值均失效
| 动态 | dt.dt-detail.0.0.pv | 动态 id |
| 专栏 | read.column-detail.roof.8.click | 文章 cvid |
| 文集 | read.column-readlist.share.0.click | 文集 rlid |
| 直播 | live.live-room-detail.0.0.pv | 直播 room_id |
| 用户 | main.space-total.more.0.click | 用户 mid |
| 课程 | pugv.pugv-video-detail.0.0.pv | 课程 id? |
| 番剧 | main.space-bangumi.0.0 | 番剧 id? |
| 链接 | public.webview.0.0.pv | ? |
-->
| 类型 | 分享 ID (share_id) | 对象 ID (oid) | 分享来源? (share_origin) | 备注 |
| --- | ------------------ | ------------- | ----------------------- | ---- |
| 视频 | `main.ugc-video-detail.0.0.pv` | 视频 aid | 非必要 | |
| 动态/图文 | `dt.dt-detail.0.0.pv` | 动态/图文 id | `dynamic` | |
| 专栏 | `read.column-detail.roof.8.click` | 文章 cvid | 非必要 | |
| 文集 | `read.column-readlist.share.0.click` | 文集 rlid | 非必要 | |
| 用户 | `main.space-total.more.0.click` | 用户 mid | 非必要 | |
| 课程 | `pugv.pugv-video-detail.0.0.pv` | 课程 id? | `vinfo_player``vinfo_share` | |
| 链接 | `public.webview.0.0.pv` | 任意站內链接 | 非必要 | 需填写完整链接,且域名必需为 `*.bilibili.com` |
<!-- 此处被注释是因为以下值均失效 -->
<!-- | 直播 | live.live-room-detail.0.0.pv | 直播 room_id | `vertical-three-point-panel` | 失效 |
| 番剧 | `pgc.pgc-video-detail.interaction.share.click` | 番剧 ssid/epid | `new_ogv` | 失效,提示 `不允许分享` | -->
**JSON回复:**

View File

@@ -14,9 +14,33 @@
| --------------- | ------ | -------- | ------ | ---- |
| id | string | 动态 id | 必要 | 数字 |
| timezone_offset | number | 时区偏移 | 非必要 | 如 `-480` |
| features | string | 功能 | 非必要 | `onlyfansVote,onlyfansAssetsV2,decorationCard,htmlNewStyle,ugcDelete,editable,opusPrivateVisible,tribeeEdit,avatarAutoTheme,avatarTypeOpus` |
| features | string | 功能 | 非必要部分专栏要求htmlNewStyle | `onlyfansVote,onlyfansAssetsV2,decorationCard,htmlNewStyle,ugcDelete,editable,opusPrivateVisible,tribeeEdit,avatarAutoTheme,avatarTypeOpus` |
**JSON 回复:**
**JSON 回复旧版专栏未携带htmlNewStyle feature时**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| code | number | 返回值 | 0: 成功<br />-352: 风控校验失败 |
| data | object | 数据本体 | |
| message | string | 错误信息 | 成功时为 `0` |
| ttl | number | `1` | |
`data` 对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| fallback | object | 回退的内容信息 | |
`fallback` 对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| id | number | 回退的内容ID | |
| type | number | 回退的内容类型 | 已知2为专栏 |
**JSON 回复(正常返回情况):**
根对象:

View File

@@ -39,7 +39,7 @@
| videos | num | 视频分P总数 | 默认为1 |
| tid | num | 分区tid | |
| tname | str | 子分区名称 | |
| copyright | num | 是否转载 | 1原创<br />2转载 |
| copyright | num | 是否转载 | 1原创<br />2转载<br />3未填写 |
| pic | str | 视频封面图片url | |
| title | str | 稿件标题 | |
| pubdate | num | 稿件发布时间 | 时间戳 |
@@ -2646,7 +2646,7 @@ curl -G 'https://app.bilibili.com/x/v2/space/likearc' \
| is_lesson_finished | num | 课堂是否已完结 | 0否<br />1是 |
| is_live_playback | num | 是否为直播回放 | 0否<br />1是 |
| is_pay | num | 0 | 作用尚不明确 |
| is_self_view | bool | false | 作用尚不明确 |
| is_self_view | bool | 是否仅自己可见 | |
| is_steins_gate | num | 是否为互动视频 | 0否<br />1是 |
| is_union_video | num | 是否为合作视频 | 0否<br />1是 |
| jump_url | str | 跳转链接 | 跳转到课堂的链接,否则为"" |

View File

@@ -42,7 +42,7 @@
| tid_v2 | num | 分区tid (v2) | 详情见[视频分区一览 (v2)](video_zone_v2.md) |
| tname | str | 子分区名称 | |
| tname_v2 | str | 子分区名称 (v2) | |
| copyright | num | 视频类型 | 1原创<br />2转载 |
| copyright | num | 视频类型 | 1原创<br />2转载<br />3未填写 |
| pic | str | 稿件封面图片url | |
| title | str | 稿件标题 | |
| pubdate | num | 稿件发布时间 | 秒级时间戳 |
@@ -65,7 +65,7 @@
| premiere | | null | |
| teenage_mode | num | | 用于青少年模式 |
| is_chargeable_season | bool | | |
| is_story | bool | 是否可以在 Story Mode 展示? | |
| is_story | bool | 是否为动态视频 | |
| is_upower_exclusive | bool | 是否为充电专属视频 | |
| is_upower_play | bool | | |
| is_upower_preview | bool | 充电专属视频是否支持试看 | |
@@ -80,8 +80,8 @@
| like_icon | str | 空串 | |
| need_jump_bv | bool | 需要跳转到BV号? | |
| disable_show_up_info | bool | 禁止展示UP主信息? | |
| is_story_play | bool | 是否为 Story Mode 视频? | |
| is_view_self | bool | 是否自己投稿的视频? | |
| is_story_play | bool | | 作用未知,可能与动态视频有关 |
| is_view_self | bool | 是否自己可见 | |
`data`中的`desc_v2`数组: