From 05fbbce54f946f2d1b027aae43a51e328c7e6fa0 Mon Sep 17 00:00:00 2001
From: SessionHu <102411014+SessionHu@users.noreply.github.com>
Date: Sat, 26 Jul 2025 09:24:54 +0800
Subject: [PATCH] feat(dynamic): update get_dynamic_detail
---
README.md | 2 +-
docs/dynamic/card_info.md | 60 ++++++-
docs/dynamic/get_dynamic_detail.md | 271 +++++++++++------------------
3 files changed, 157 insertions(+), 176 deletions(-)
diff --git a/README.md b/README.md
index a90cd3d..cfc375d 100644
--- a/README.md
+++ b/README.md
@@ -171,7 +171,7 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接
- [ ] [获取动态列表](docs/dynamic/all.md)
- [ ] [用户空间动态](docs/dynamic/space.md)
- [ ] [动态基本信息](docs/dynamic/basicInfo.md)
- - [ ] [动态详细信息字段](docs/dynamic/card_info.md)
+ - [ ] [动态卡片信息字段](docs/dynamic/card_info.md)
- [ ] [获取动态详情](docs/dynamic/detail.md)
- [ ] [动态类型对照](docs/dynamic/dynamic_enum.md)
- [ ] [动态信息](docs/dynamic/content.md)
diff --git a/docs/dynamic/card_info.md b/docs/dynamic/card_info.md
index cf7195d..22e17d8 100644
--- a/docs/dynamic/card_info.md
+++ b/docs/dynamic/card_info.md
@@ -1,6 +1,6 @@
-# 动态详细信息字段
+# 动态卡片信息字段
-不同动态内容卡片的具体信息。包含在 [获取特定动态卡片信息](get_dynamic_detail.md#获取特定动态卡片信息)，[话题下特定动态信息](topic.md#话题下特定动态信息) 等 API 的 JSON 回复中
+不同动态内容卡片的具体信息。包含在 [获取特定动态卡片信息](get_dynamic_detail.md#获取特定动态卡片信息) 等 API 的 JSON 回复中
以card字段的形式出现，内容为一个可被解析为Json对象的字符串。
@@ -8,7 +8,7 @@
****
-## 在转发类动态中（type=1）
+## 转发动态 (type=1)
需注意账号转发视频投稿，其他用户的动态以及分享收藏夹等均为转发类内容，并不属于type=4300的收藏类动态等。
@@ -104,7 +104,7 @@
-## 在图片动态中（type=2）
+## 图片动态 (type=2)
在type=2的图片动态中，解析出的对象包含以下内容：
@@ -168,7 +168,7 @@
-## 在文字动态中（type=4）
+## 文字动态 (type=4)
在type=4的文字动态中，解析出的对象包含以下内容：
@@ -203,7 +203,7 @@
-## 在视频投稿动态中（type=8）
+## 视频投稿动态 (type=8)
在type=8的视频投稿动态中，解析出的对象包含以下内容：
@@ -302,7 +302,11 @@
-## 在专栏投稿动态中（type=64）
+## 小视频 (type=16)
+
+## 戏剧? (type=32)
+
+## 专栏投稿动态 (type=64)
在type=64的专栏投稿动态中，解析出的对象包含以下内容：
@@ -449,7 +453,7 @@
-## 在音频投稿动态中（type=256）
+## 音频投稿动态 (type=256)
在type=256的音频投稿动态中，解析出的对象包含以下内容：
@@ -490,3 +494,43 @@
```
+
+## 番剧 (type=512)
+
+## ??? (type=1000)
+
+## ??? (type=1001)
+
+## ??? (type=1024)
+
+## H5 活动动态 (type=2048)
+
+## 漫画分享 (type=2049)
+
+## PGC 番剧 (type=4097)
+
+## 电影 (type=4098)
+
+## 电视剧 (type=4099)
+
+## 国创动漫 (type=4100)
+
+## 纪录片 (type=4101)
+
+## 直播 (type=4200)
+
+## 直播 (type=4201)
+
+## 收藏夹 (type=4300)
+
+## 付费课程 (type=4302)
+
+## 付费课程 (type=4303)
+
+## 直播 (type=4308)
+
+## 合集 (type=4310)
+
+## ??? (type=4311)
+
+## ??? (type=268435455)
diff --git a/docs/dynamic/get_dynamic_detail.md b/docs/dynamic/get_dynamic_detail.md
index e6182ab..2457122 100644
--- a/docs/dynamic/get_dynamic_detail.md
+++ b/docs/dynamic/get_dynamic_detail.md
@@ -1,8 +1,10 @@
-# 获取特定动态卡片信息
+# 特定动态卡片信息
+
+## 获取特定动态卡片信息
> https://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/get_dynamic_detail
-*请求方式：GET*
+*请求方法: GET*
**url参数：**
@@ -16,60 +18,26 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
-| code | num | 返回值 | 0：成功 |
-| data | obj | 信息本体 | |
-| message | str | 错误信息 | 默认为空 |
-| msg | num | 空 | |
+| code | number | 返回值 | 0: 成功
4128001: 请求数据发生错误，请刷新或稍后重试 |
+| data | object | 信息本体 | 失败时为 `null` |
+| message | string | 错误信息 | 成功时为 `0` |
+| ttl | number | `1` | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ----- | ---------- | ------------ |
-| card | obj | 动态卡片内容 | 当动态不存在/删除时不返回此项 |
-| result | num | 0 | 作用尚不明确（当动态不存在/删除时不返回此项） |
-| \_gt\_ | num | 0 | 作用尚不明确 |
+| card | object | 动态卡片内容 | 当动态不存在/删除时不返回此项 |
`data`中的`card`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------- | ---- |
| activity_infos | obj | 该条动态参与的活动 |当此条动态没有参与任何活动时不显示此项 |
-| card | str | 动态详细信息 | 会跟随此动态类型不同发生一定的变化，评论数、点赞数等相关信息参考`desc`字段 |
+| card | str | 动态详细信息 | 会跟随此动态类型不同发生一定的变化，评论数、点赞数等相关信息参考`desc`字段, 详细可见 [动态详细信息字段](card_info.md) |
| desc | obj | 动态相关信息 | 会跟随此动态类型不同发生一定的变化，详细信息（例如动态描述等）参考`card`字段 |
| display | obj | 动态部分的可操作项 | 会随着动态类型发生变化，主要用于显示动态 |
| extend_json | str | 动态扩展项 | 会随着动态类型发生变化 |
-**此处的大部分字段的内容都会根据`desc`中的`type`值发生一定变化，具体的数值对照参考下表（仅作参考，部分内容的解释未知，同时有些内容仅为在部分页面出现，无法通过此API调出）：**
-
-| 值 | 含义 |
-| ---- | ---- |
-| 268435455 | 具体定义未知 |
-| 1 | 转发 |
-| 2 | 图片动态 |
-| 4 | 文字动态 |
-| 8 | 视频动态 |
-| 16 | 小视频 |
-| 32 | 具体定义未知（可能为戏剧） |
-| 64 | 专栏 |
-| 256 | 音频 |
-| 512 | 番剧 |
-| 1024 | 具体定义未知 |
-| 2048 | H5活动动态 |
-| 2049 | 漫画分享 |
-| 4097 | PGC番剧 |
-| 4098 | 电影 |
-| 4099 | 电视剧 |
-| 4100 | 国创动漫 |
-| 4101 | 纪录片 |
-| 4200 | 直播 |
-| 4201 | 直播 |
-| 4300 | 收藏夹 |
-| 4302 | 付费课程 |
-| 4303 | 付费课程 |
-| 4308 | 直播 |
-| 4310 | 合集 |
-| 4311 | 具体定义未知 |
-| 1e3 | 具体定义未知 |
-| 1001 | 具体定义未知 |
**示例：**
@@ -81,137 +49,106 @@ curl -G 'https://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/get_dynamic_deta
```
-查看响应示例
+查看响应示例:
```json
{
- "code": 0,
- "msg": "",
- "message": "",
- "data": {
- "card": {
- "desc": {
- "uid": 8047632,
- "type": 8,
- "rid": 204774719,
- "acl": 0,
- "view": 1182282,
- "repost": 405,
- "like": 31940,
- "is_liked": 0,
- "dynamic_id": 507420325550127049,
- "timestamp": 1616981401,
- "pre_dy_id": 0,
- "orig_dy_id": 0,
- "orig_type": 0,
- "user_profile": {
- "info": {
- "uid": 8047632,
- "uname": "哔哩哔哩弹幕网",
- "face": "https://i0.hdslb.com/bfs/face/f2cb8d9854156e3f26d4c6751d6eeb9c30e21847.jpg"
- },
- "card": {
- "official_verify": {
- "type": 1,
- "desc": "哔哩哔哩弹幕网官方账号 "
- }
- },
- "vip": {
- "vipType": 2,
- "vipDueDate": 1924531200000,
- "vipStatus": 1,
- "themeType": 0,
- "label": {
- "path": "",
- "text": "十年大会员",
- "label_theme": "ten_annual_vip",
- "text_color": "#FFFFFF",
- "bg_style": 1,
- "bg_color": "#FB7299",
- "border_color": ""
- },
- "avatar_subscript": 1,
- "nickname_color": "#FB7299",
- "role": 7,
- "avatar_subscript_url": "https://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png"
- },
- "pendant": {
- "pid": 3860,
- "name": "2021拜年纪",
- "image": "https://i0.hdslb.com/bfs/garb/item/7f8aa8ef1eed8c2dce0796801ddc82552a4164f9.png",
- "expire": 0,
- "image_enhance": "https://i0.hdslb.com/bfs/garb/item/7f8aa8ef1eed8c2dce0796801ddc82552a4164f9.png",
- "image_enhance_frame": ""
- },
- "rank": "10000",
- "sign": "哔哩哔哩 干杯 - ( ゜- ゜)つロ",
- "level_info": {
- "current_level": 6
- }
- },
- "uid_type": 1,
- "stype": 0,
- "r_type": 1,
- "inner_id": 0,
- "status": 1,
- "dynamic_id_str": "507420325550127049",
- "pre_dy_id_str": "0",
- "orig_dy_id_str": "0",
- "rid_str": "204774719",
- "bvid": "BV1Dh411S7sS"
- },
- "card": "{\"aid\":204774719,\"attribute\":0,\"cid\":316514988,\"copyright\":1,\"ctime\":1616939233,\"desc\":\"2021年3月29日9:30（北京时间），B站在中国香港港交所成功挂牌二次上市。欢迎来到bilibili这座乐园，和超过2亿中国年轻人一起表达自我、拥抱世界。\",\"dimension\":{\"height\":1080,\"rotate\":0,\"width\":1920},\"duration\":290,\"dynamic\":\"\",\"item\":{\"at_control\":\"\"},\"jump_url\":\"bilibili:\\/\\/video\\/204774719\\/?page=1&player_preload=null&player_width=1920&player_height=1080&player_rotate=0\",\"owner\":{\"face\":\"https:\\/\\/i0.hdslb.com\\/bfs\\/face\\/f2cb8d9854156e3f26d4c6751d6eeb9c30e21847.jpg\",\"mid\":8047632,\"name\":\"哔哩哔哩弹幕网\"},\"pic\":\"https:\\/\\/i0.hdslb.com\\/bfs\\/archive\\/bcbcac6560268ef9cbe59fbf759ac28adf5e0432.jpg\",\"player_info\":null,\"pubdate\":1616981400,\"rights\":{\"autoplay\":1,\"bp\":0,\"download\":0,\"elec\":0,\"hd5\":1,\"is_cooperation\":0,\"movie\":0,\"no_background\":0,\"no_reprint\":1,\"pay\":0,\"ugc_pay\":0,\"ugc_pay_preview\":0},\"share_subtitle\":\"已观看24.0万次\",\"short_link\":\"https:\\/\\/b23.tv\\/BV1Dh411S7sS\",\"short_link_v2\":\"https:\\/\\/b23.tv\\/BV1Dh411S7sS\",\"stat\":{\"aid\":204774719,\"coin\":8661,\"danmaku\":744,\"dislike\":0,\"favorite\":6025,\"his_rank\":0,\"like\":31940,\"now_rank\":0,\"reply\":1619,\"share\":2134,\"view\":246956},\"state\":0,\"tid\":207,\"title\":\"欢迎来到2亿年轻人的乐园——bilibili 回香港上市啦！\",\"tname\":\"财经\",\"videos\":1}",
- "extend_json": "{\"\":{\"ogv\":{\"ogv_id\":0}},\"dispute\":{\"content\":\"\"},\"from\":{\"from\":\"\"},\"like_icon\":{\"action\":\"\",\"action_url\":\"\",\"end\":\"\",\"end_url\":\"\",\"start\":\"\",\"start_url\":\"\"},\"topic\":{\"is_attach_topic\":1}}",
- "display": {
- "topic_info": {
- "topic_details": [
- {
- "topic_id": 12895437,
- "topic_name": "二次上市",
- "is_activity": 0,
- "topic_link": ""
- },
- {
- "topic_id": 10967402,
- "topic_name": "香港上市",
- "is_activity": 1,
- "topic_link": "https://www.bilibili.com/blackboard/dynamic/102930"
- },
- {
- "topic_id": 114859,
- "topic_name": "B站",
- "is_activity": 0,
- "topic_link": ""
- },
- {
- "topic_id": 8312,
- "topic_name": "宣传片",
- "is_activity": 1,
- "topic_link": "https://www.bilibili.com/blackboard/dynamic/8795"
- },
- {
- "topic_id": 679,
- "topic_name": "BILIBILI",
- "is_activity": 0,
- "topic_link": ""
- }
- ]
- },
- "usr_action_txt": "投稿了视频",
- "relation": {
- "status": 1,
- "is_follow": 0,
- "is_followed": 0
- },
- "show_tip": {
- "del_tip": "要删除动态吗？"
- },
- "cover_play_icon_url": "https://i0.hdslb.com/bfs/album/2269afa7897830b397797ebe5f032b899b405c67.png"
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "card": {
+ "desc": {
+ "uid": 8047632,
+ "type": 8,
+ "rid": 204774719,
+ "acl": 0,
+ "view": 0,
+ "repost": 0,
+ "comment": 0,
+ "like": 0,
+ "is_liked": 0,
+ "dynamic_id": 507420325550127040,
+ "timestamp": 1616981401,
+ "pre_dy_id": 0,
+ "orig_dy_id": 0,
+ "orig_type": 0,
+ "user_profile": {
+ "info": {
+ "uid": 8047632,
+ "uname": "哔哩哔哩弹幕网",
+ "face": "https://i0.hdslb.com/bfs/face/0c84b9f4ad546d3f20324809d45fc439a2a8ddab.jpg"
+ },
+ "card": {
+ "official_verify": {
+ "type": -1
}
+ },
+ "vip": {
+ "vipType": 2,
+ "vipDueDate": 1924963200000,
+ "dueRemark": "",
+ "accessStatus": 0,
+ "vipStatus": 1,
+ "vipStatusWarn": "",
+ "themeType": 0,
+ "label": {
+ "path": "http://i0.hdslb.com/bfs/vip/label_annual.png",
+ "text": "十年大会员",
+ "label_theme": "ten_annual_vip",
+ "text_color": "#FFFFFF",
+ "bg_style": 1,
+ "bg_color": "#FB7299",
+ "border_color": ""
+ },
+ "avatar_subscript": 1,
+ "nickname_color": "#FB7299",
+ "role": 7,
+ "avatar_subscript_url": ""
+ },
+ "pendant": {
+ "pid": 0,
+ "name": "",
+ "image": "",
+ "expire": 0,
+ "image_enhance": "",
+ "image_enhance_frame": ""
+ },
+ "rank": "10000",
+ "sign": "哔哩哔哩 干杯 ( ゜- ゜)つロ",
+ "level_info": {
+ "current_level": 6,
+ "current_min": 0,
+ "current_exp": 0,
+ "next_exp": ""
+ }
},
- "result": 0,
- "_gt_": 0
+ "spec_type": 0,
+ "uid_type": 1,
+ "stype": 0,
+ "r_type": 1,
+ "inner_id": 0,
+ "status": 1,
+ "dynamic_id_str": "507420325550127049",
+ "pre_dy_id_str": "0",
+ "orig_dy_id_str": "0",
+ "rid_str": "204774719",
+ "origin": null,
+ "bvid": "BV1Dh411S7sS",
+ "previous": null
+ },
+ "card": "{\"aid\":204774719,\"cid\":316514988,\"ctime\":1616981401,\"desc\":\"2021年3月29日9:30（北京时间），B站在中国香港港交所成功挂牌二次上市。欢迎来到bilibili这座乐园，和超过2亿中国年轻人一起表达自我、拥抱世界。\",\"dimension\":{\"height\":1080,\"rotate\":0,\"width\":1920},\"duration\":290,\"dynamic\":\"\",\"first_frame\":\"\",\"jump_url\":\"bilibili://video/204774719/?page=1\\u0026player_width=1920\\u0026player_height=1080\\u0026player_rotate=0\",\"owner\":{\"face\":\"https://i0.hdslb.com/bfs/face/0c84b9f4ad546d3f20324809d45fc439a2a8ddab.jpg\",\"mid\":8047632,\"name\":\"哔哩哔哩弹幕网\"},\"pic\":\"http://i0.hdslb.com/bfs/archive/bcbcac6560268ef9cbe59fbf759ac28adf5e0432.jpg\",\"pubdate\":1616981400,\"short_link_v2\":\"\",\"stat\":{\"aid\":204774719,\"coin\":9016,\"danmaku\":742,\"dislike\":0,\"favorite\":5463,\"like\":32802,\"reply\":1603,\"share\":2517,\"view\":278278},\"state\":0,\"tid\":207,\"title\":\"欢迎来到2亿年轻人的乐园——bilibili 回香港上市啦！\",\"tname\":\"财经商业\",\"videos\":1}",
+ "extend_json": "{\"from\":{\"from\":\"\",\"emoji_type\":1},\"ctrl\":null,\"lott\":null}",
+ "display": {
+ "origin": null,
+ "usr_action_txt": "投稿了视频",
+ "relation": null,
+ "live_info": null,
+ "emoji_info": null,
+ "highlight": null
+ }
}
+ }
}
```