bilibili-API-collect/docs/misc/b23tv.md

b23.tv 短链

简述

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

格式

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

• 任意短链, 路径由7位数字或大小写英文字母组成, 为防止滥用似乎有时效限制, 如 https://b23.tv/pigt3PQ

• 视频短链(AV号), 路径由字符串 av 尾随 视频 aid 组成, 如 https://b23.tv/av80433022

• 视频短链(BV号), 路径由字符串 BV 尾随 视频 bvid 组成, 如 https://b23.tv/BV1GJ411x7h7

生成

视频短链

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
  }
}