feat(dynamic/topic.md): add topic details

This commit is contained in:
SessionHu 2025-07-26 11:29:08 +08:00
parent 5908767912
commit a8c58a6234
No known key found for this signature in database
GPG Key ID: 9E7E64C25FE3301A

View File

@ -5571,3 +5571,166 @@ curl -G 'https://app.bilibili.com/x/topic/web/dynamic/rcmd?page_size=9'
</details> </details>
<!-- Generated by json-apidoc-gen @ 2025-07-26T02:37:34.536597611Z --> <!-- Generated by json-apidoc-gen @ 2025-07-26T02:37:34.536597611Z -->
## 获取指定话题详细信息
> https://app.bilibili.com/x/topic/web/details/top
*请求方法: GET*
<!-- #1360 -->
**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'
```
<details>
<summary>查看响应示例:</summary>
```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
}
```
</details>
<!-- Generated by json-apidoc-gen @ 2025-07-26T03:17:14.502472328Z -->