From a8c58a62343462eda5b1b4d6c35d38fe6686d8c8 Mon Sep 17 00:00:00 2001 From: SessionHu <102411014+SessionHu@users.noreply.github.com> Date: Sat, 26 Jul 2025 11:29:08 +0800 Subject: [PATCH] feat(dynamic/topic.md): add topic details --- docs/dynamic/topic.md | 163 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 163 insertions(+) diff --git a/docs/dynamic/topic.md b/docs/dynamic/topic.md index a38c6ef..d553635 100644 --- a/docs/dynamic/topic.md +++ b/docs/dynamic/topic.md @@ -5571,3 +5571,166 @@ curl -G 'https://app.bilibili.com/x/topic/web/dynamic/rcmd?page_size=9' + +## 获取指定话题详细信息 + +> https://app.bilibili.com/x/topic/web/details/top + +*请求方法: GET* + + + +**URL 参数:** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | ---- | ------ | ---- | +| topic_id | number | 话题 id | 必要 | | +| source | string | 来源 | 不必要 | 如 `Web` `H5` | +| web_location | string | `333.1036` | 不必要 | 当 `source` 为 `H5` 时 | + +**JSON 回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| code | number | 返回值 | 0: 成功 | +| data | object | 数据本体 | | +| message | string | 错误信息 | 成功时为 `0` | +| ttl | number | `1` | | + +`data` 对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| click_area_card | object | 点击区域卡片? | | +| functional_card | object | 功能卡片 | | +| top_details | object | 话题详情 | | + +`data.click_area_card` 对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | + +`data.functional_card` 对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| traffic_card | object | 引流卡片 | | + +`data.functional_card.traffic_card` 对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| benefit_point | string | 奖励点 | | +| card_desc | string | 卡片描述 | | +| icon_url | string | 图标 URL | | +| jump_title | string | 跳转标题 | | +| jump_url | string | 跳转 URL | | +| name | string | 名称 | | + +`data.top_details` 对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| close_pub_layer_entry | boolean | 是否关闭发布层入口? | | +| has_create_jurisdiction | boolean | 是否有创建权限? | | +| operation_content | object | 操作内容? | | +| topic_creator | object | 话题创建者 | | +| topic_item | object | 话题详情 | | +| word_color | number | 话题字体颜色? | | + +`data.top_details.operation_content` 对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | + +`data.top_details.topic_creator` 对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| face | string | 头像 URL | | +| name | string | 昵称 | | +| uid | number | mid (UID) | | + +`data.top_details.topic_item` 对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ---- | +| back_color | string | 背景色 | | +| ctime | number | 创建时间 | | +| description | string | 话题描述 | | +| discuss | number | 讨论数 | | +| dynamics | number | 动态数 | | +| fav | number | 收藏数 | | +| id | number | 话题 id | | +| jump_url | string | 跳转 URL | | +| like | number | 点赞数 | | +| name | string | 话题名 | | +| share | number | 分享数 | | +| share_pic | string | 分享图片 URL | 似乎就是话题的图标 | +| share_url | string | 分享的 URL | | +| show_interact_data | boolean | 显示互动数据? | | +| view | number | 浏览数 | | + +**示例:** + +```shell +curl -G 'https://app.bilibili.com/x/topic/web/details/top' \ +--url-query 'topic_id=1314000' +``` + +
+查看响应示例: + +```json +{ + "code": 0, + "data": { + "click_area_card": {}, + "functional_card": { + "traffic_card": { + "benefit_point": "投稿4K视频瓜分千万流量&奖金", + "card_desc": "2025-10-01 00:00截止", + "icon_url": "https://i0.hdslb.com/bfs/activity-plat/static/20211019/4c5b6134e2def772efe20dabcca1f6e1/vGqnSBjy8N.png", + "jump_title": "立即参与", + "jump_url": "https://www.bilibili.com/blackboard/era/4Kchaoqingpc.html", + "name": "眼见帧实·B站超高清视频计划" + } + }, + "top_details": { + "close_pub_layer_entry": false, + "has_create_jurisdiction": false, + "operation_content": {}, + "topic_creator": { + "face": "https://i0.hdslb.com/bfs/face/9da46bf581938ff29c2143f186b3f66409c11bf6.jpg", + "name": "赛博星人科技汪", + "uid": 394205865 + }, + "topic_item": { + "back_color": "#6188FF", + "ctime": 1750734201, + "description": "来B站，分享你的超高清视频！2025.6.30-9.30期间，参与“眼见帧实·B站超高清视频计划”活动，投稿超清视频，可以分享超清开箱、超清vlog、超清科普、超清美食、超清风光大片等内容！丰厚奖金&礼物等你来拿~", + "discuss": 435100, + "dynamics": 7902, + "fav": 15, + "id": 1314000, + "jump_url": "https://m.bilibili.com/topic-detail?topic_id=1314000", + "like": 19, + "name": "B站超高清视频计划", + "share": 7, + "share_pic": "http://i0.hdslb.com/bfs/vc/7701fba940e721ceb756cc73694ebb8f510fe0cc.png", + "share_url": "https://m.bilibili.com/topic-detail?topic_id=1314000", + "show_interact_data": true, + "view": 90735677 + }, + "word_color": 0 + } + }, + "message": "0", + "ttl": 1 +} +``` +
+ +