Files
Bilibili-gadget/bilibili-API-collect-master/docs/misc/b23tv.md
T
mckero 8db1d171a0 feat: 重大优化更新 - 修复v14.0并发布Pro版
✨ 新功能:
- 创建bilibili_audio_downloader_pro.py (Pro版) - 全新架构重构
- 添加config.json配置文件支持
- 新增INSTALL.md详细安装指南
- 新增VERSION_COMPARISON.md版本对比说明

🐛 Bug修复 (v14.0):
- 修复中文编码显示问题
- 修复ffmpeg进度条计算不准确
- 改进yt-dlp下载进度解析
- 添加重试机制和超时设置
- 完善错误处理和日志记录

🏗️ Pro版优势:
- 面向对象架构设计,代码更清晰
- 自定义异常类和智能错误恢复
- 准确的进度条显示算法
- 完整的日志系统
- 灵活的配置管理
- 更好的用户体验

📚 文档更新:
- 更新README.md,添加版本对比指引
- 更新requirements.txt依赖列表
- 完善项目文档结构
2025-09-21 12:02:11 +08:00

4.4 KiB

b23.tv 短链

简述

b23.tv 是由 Bilibili 提供的短链服务, 主要用于站内长链接缩短便于分享, 目前仅在手机客户端生成

格式

目前已知的 b23.tv 短链格式有以下 3 种

生成

视频短链

  1. 直接手动拼接字符串即可

  2. 参见任意短链

任意短链

https://api.bilibili.com/x/share/click
https://api.biliapi.net/x/share/click

请求方式: POST

认证方式: 仅APP, 但实际上形同虚设

注: 该接口参数对照表基本失效, 基本无实用价值, 已被注释, 参见 #979 Nemo2011/bilibili-api#720

正文参数(application/x-www-form-urlencoded):

必要:

参数名 类型 内容 必要性 备注
buvid str 设备 BUVID 必要 实际任意非空字符串即可
build num 客户端版本号 必要 大于 5520400 的任意有效整数, 如 7710300
platform str 客户端平台 必要 实际任意非空字符串即可
share_channel str 分享方式? 必要 COPY
share_mode num 分享模式? 必要 任意有效正整数, 常见 1, 3, 4
share_id str 分享 ID 必要 见下方对照表
oid num 对象 ID 必要 见下方对照表

不必要:

参数名 类型 内容 必要性 备注
object_extra_fields obj 额外字段? 非必要 如 {"jumpfrom_id":30104} {"epid":"409808","cid":"1398781253"} {"season_type":"1","season_id":"39481","epid":"425006","dubbing_support":false,"background_audio":false,"role_audio_list":false}
panel_type num 面板类型? 非必要 1
share_title str 分享标题? 非必要 分享标题
share_content str 分享内容? 非必要 分享内容, 当 oid 存在时无意义(可是 oid 不可能不存在啊)
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

JSON回复:

根对象:

字段名 类型 内容 备注
code num 0 恒为 0
message str 0 恒为 0
ttl num 1 恒为 1
data obj 信息本体

data 对象:

字段名 类型 内容 备注
content str 短链内容 若失败则不存在
count num 0 恒为 0

示例:

为 av80433022 生成 b23.tv 短链

curl -X POST "http://api.biliapi.net/x/share/click" \
--data-urlencode "platform=unix" \
--data-urlencode "share_channel=COPY" \
--data-urlencode "share_id=main.ugc-video-detail.0.0.pv" \
--data-urlencode "share_mode=4" \
--data-urlencode "oid=80433022" \
--data-urlencode "buvid=qwq" \
--data-urlencode "build=6114514"
查看响应示例:
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "content": "【【官方 MV】Never Gonna Give You Up - Rick Astley-哔哩哔哩】 https://b23.tv/5x4wy5f",
    "count": 0
  }
}