返回提交历史
Modified
docs/dynamic/topic.md
+163
-0
XFEstudio/bilibili-API-collect
feat(dynamic/topic.md): add topic details
a8c58a6
代码差异
1 个文件
+163
-0
@@ -5571,3 +5571,166 @@ curl -G 'https://app.bilibili.com/x/topic/web/dynamic/rcmd?page_size=9'
5571
5571
</details>
5572
5572
5573
5573
<!-- Generated by json-apidoc-gen @ 2025-07-26T02:37:34.536597611Z -->
5574
5575
## 获取指定话题详细信息
5576
5577
> https://app.bilibili.com/x/topic/web/details/top
5578
5579
*请求方法: GET*
5580
5581
<!-- #1360 -->
5582
5583
**URL 参数:**
5584
5585
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
5586
| ------ | ---- | ---- | ------ | ---- |
5587
| topic_id | number | 话题 id | 必要 | |
5588
| source | string | 来源 | 不必要 | 如 `Web` `H5` |
5589
| web_location | string | `333.1036` | 不必要 | 当 `source` 为 `H5` 时 |
5590
5591
**JSON 回复:**
5592
5593
根对象:
5594
5595
| 字段 | 类型 | 内容 | 备注 |
5596
| ---- | ---- | ---- | ---- |
5597
| code | number | 返回值 | 0: 成功 |
5598
| data | object | 数据本体 | |
5599
| message | string | 错误信息 | 成功时为 `0` |
5600
| ttl | number | `1` | |
5601
5602
`data` 对象:
5603
5604
| 字段 | 类型 | 内容 | 备注 |
5605
| ---- | ---- | ---- | ---- |
5606
| click_area_card | object | 点击区域卡片? | |
5607
| functional_card | object | 功能卡片 | |
5608
| top_details | object | 话题详情 | |
5609
5610
`data.click_area_card` 对象:
5611
5612
| 字段 | 类型 | 内容 | 备注 |
5613
| ---- | ---- | ---- | ---- |
5614
5615
`data.functional_card` 对象:
5616
5617
| 字段 | 类型 | 内容 | 备注 |
5618
| ---- | ---- | ---- | ---- |
5619
| traffic_card | object | 引流卡片 | |
5620
5621
`data.functional_card.traffic_card` 对象:
5622
5623
| 字段 | 类型 | 内容 | 备注 |
5624
| ---- | ---- | ---- | ---- |
5625
| benefit_point | string | 奖励点 | |
5626
| card_desc | string | 卡片描述 | |
5627
| icon_url | string | 图标 URL | |
5628
| jump_title | string | 跳转标题 | |
5629
| jump_url | string | 跳转 URL | |
5630
| name | string | 名称 | |
5631
5632
`data.top_details` 对象:
5633
5634
| 字段 | 类型 | 内容 | 备注 |
5635
| ---- | ---- | ---- | ---- |
5636
| close_pub_layer_entry | boolean | 是否关闭发布层入口? | |
5637
| has_create_jurisdiction | boolean | 是否有创建权限? | |
5638
| operation_content | object | 操作内容? | |
5639
| topic_creator | object | 话题创建者 | |
5640
| topic_item | object | 话题详情 | |
5641
| word_color | number | 话题字体颜色? | |
5642
5643
`data.top_details.operation_content` 对象:
5644
5645
| 字段 | 类型 | 内容 | 备注 |
5646
| ---- | ---- | ---- | ---- |
5647
5648
`data.top_details.topic_creator` 对象:
5649
5650
| 字段 | 类型 | 内容 | 备注 |
5651
| ---- | ---- | ---- | ---- |
5652
| face | string | 头像 URL | |
5653
| name | string | 昵称 | |
5654
| uid | number | mid (UID) | |
5655
5656
`data.top_details.topic_item` 对象:
5657
5658
| 字段 | 类型 | 内容 | 备注 |
5659
| ---- | ---- | ---- | ---- |
5660
| back_color | string | 背景色 | |
5661
| ctime | number | 创建时间 | |
5662
| description | string | 话题描述 | |
5663
| discuss | number | 讨论数 | |
5664
| dynamics | number | 动态数 | |
5665
| fav | number | 收藏数 | |
5666
| id | number | 话题 id | |
5667
| jump_url | string | 跳转 URL | |
5668
| like | number | 点赞数 | |
5669
| name | string | 话题名 | |
5670
| share | number | 分享数 | |
5671
| share_pic | string | 分享图片 URL | 似乎就是话题的图标 |
5672
| share_url | string | 分享的 URL | |
5673
| show_interact_data | boolean | 显示互动数据? | |
5674
| view | number | 浏览数 | |
5675
5676
**示例:**
5677
5678
```shell
5679
curl -G 'https://app.bilibili.com/x/topic/web/details/top' \
5680
--url-query 'topic_id=1314000'
5681
```
5682
5683
<details>
5684
<summary>查看响应示例:</summary>
5685
5686
```json
5687
{
5688
"code": 0,
5689
"data": {
5690
"click_area_card": {},
5691
"functional_card": {
5692
"traffic_card": {
5693
"benefit_point": "投稿4K视频瓜分千万流量&奖金",
5694
"card_desc": "2025-10-01 00:00截止",
5695
"icon_url": "https://i0.hdslb.com/bfs/activity-plat/static/20211019/4c5b6134e2def772efe20dabcca1f6e1/vGqnSBjy8N.png",
5696
"jump_title": "立即参与",
5697
"jump_url": "https://www.bilibili.com/blackboard/era/4Kchaoqingpc.html",
5698
"name": "眼见帧实·B站超高清视频计划"
5699
}
5700
},
5701
"top_details": {
5702
"close_pub_layer_entry": false,
5703
"has_create_jurisdiction": false,
5704
"operation_content": {},
5705
"topic_creator": {
5706
"face": "https://i0.hdslb.com/bfs/face/9da46bf581938ff29c2143f186b3f66409c11bf6.jpg",
5707
"name": "赛博星人科技汪",
5708
"uid": 394205865
5709
},
5710
"topic_item": {
5711
"back_color": "#6188FF",
5712
"ctime": 1750734201,
5713
"description": "来B站,分享你的超高清视频!2025.6.30-9.30期间,参与“眼见帧实·B站超高清视频计划”活动,投稿超清视频,可以分享超清开箱、超清vlog、超清科普、超清美食、超清风光大片等内容!丰厚奖金&礼物等你来拿~",
5714
"discuss": 435100,
5715
"dynamics": 7902,
5716
"fav": 15,
5717
"id": 1314000,
5718
"jump_url": "https://m.bilibili.com/topic-detail?topic_id=1314000",
5719
"like": 19,
5720
"name": "B站超高清视频计划",
5721
"share": 7,
5722
"share_pic": "http://i0.hdslb.com/bfs/vc/7701fba940e721ceb756cc73694ebb8f510fe0cc.png",
5723
"share_url": "https://m.bilibili.com/topic-detail?topic_id=1314000",
5724
"show_interact_data": true,
5725
"view": 90735677
5726
},
5727
"word_color": 0
5728
}
5729
},
5730
"message": "0",
5731
"ttl": 1
5732
}
5733
```
5734
</details>
5735
5736
<!-- Generated by json-apidoc-gen @ 2025-07-26T03:17:14.502472328Z -->