bpi_rs/video_ranking/
popular.rs

1use crate::{BilibiliRequest, BpiClient, BpiError, BpiResponse};
2use serde::{Deserialize, Serialize};
3
4// --- 获取当前热门视频列表 ---
5
6/// 热门视频列表的页面信息
7#[derive(Debug, Clone, Deserialize, Serialize)]
8pub struct PopularListData {
9    /// 视频列表
10    pub list: Vec<serde_json::Value>, // 视频内容复杂，这里用Value代替
11    /// 是否有更多数据
12    pub no_more: bool,
13}
14
15// --- 每周必看全部列表 ---
16
17/// 每周必看列表中的单个必看
18#[derive(Debug, Clone, Deserialize, Serialize)]
19pub struct PopularSeriesItem {
20    /// 期数
21    pub number: u32,
22    /// 主题
23    pub subject: String,
24    /// 状态，2: 已结束
25    pub status: u8,
26    /// 名称，如 "yyyy第n期 MM.dd - MM.dd"
27    pub name: String,
28}
29
30/// 每周必看全部列表数据
31#[derive(Debug, Clone, Deserialize, Serialize)]
32pub struct PopularSeriesListData {
33    /// 全部信息列表
34    pub list: Vec<PopularSeriesItem>,
35}
36
37// --- 每周必看选期详细信息 ---
38
39/// 每周必看选期信息
40#[derive(Debug, Clone, Deserialize, Serialize)]
41pub struct PopularSeriesConfig {
42    /// 选期 ID
43    pub id: u64,
44    /// 选期类型
45    #[serde(rename = "type")]
46    pub type_name: String,
47    /// 期数
48    pub number: u32,
49    /// 主题
50    pub subject: String,
51    /// 开始时间
52    pub stime: u64,
53    /// 结束时间
54    pub etime: u64,
55    /// 状态，2: 已结束
56    pub status: u8,
57    /// 名称
58    pub name: String,
59    /// 标题
60    pub label: String,
61    /// 提示
62    pub hint: String,
63    /// 颜色
64    pub color: u32,
65    /// 封面
66    pub cover: String,
67    /// 分享标题
68    pub share_title: String,
69    /// 分享副标题
70    pub share_subtitle: String,
71    /// 媒体 ID
72    pub media_id: u64,
73}
74
75/// 每周必看选期详细信息数据
76#[derive(Debug, Clone, Deserialize, Serialize)]
77pub struct PopularSeriesOneData {
78    /// 选期信息
79    pub config: PopularSeriesConfig,
80    /// 提醒
81    pub reminder: Option<String>,
82    /// 选期视频列表
83    pub list: Vec<serde_json::Value>,
84}
85
86impl BpiClient {
87    /// 获取当前热门视频列表
88    ///
89    /// 文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video_ranking/popular.html#获取当前热门视频列表
90    ///
91    /// # 参数
92    /// | 名称 | 类型         | 说明                 |
93    /// | ---- | ------------| -------------------- |
94    /// | `pn` | Option<u32> | 页码，可选           |
95    /// | `ps` | Option<u32> | 每页数量，可选       |
96    pub async fn video_popular_list(
97        &self,
98        pn: Option<u32>,
99        ps: Option<u32>,
100    ) -> Result<BpiResponse<PopularListData>, BpiError> {
101        let mut request = self.get("https://api.bilibili.com/x/web-interface/popular");
102
103        if let Some(pn) = pn {
104            request = request.query(&[("pn", pn)]);
105        }
106        if let Some(ps) = ps {
107            request = request.query(&[("ps", ps)]);
108        }
109
110        request.send_bpi("获取当前热门视频列表").await
111    }
112
113    /// 获取每周必看全部列表
114    ///
115    /// 文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video_ranking/popular.html#获取每周必看全部列表
116    ///
117    pub async fn video_popular_series_list(
118        &self,
119    ) -> Result<BpiResponse<PopularSeriesListData>, BpiError> {
120        self.get("https://api.bilibili.com/x/web-interface/popular/series/list")
121            .send_bpi("获取每周必看全部列表")
122            .await
123    }
124
125    /// 获取每周必看选期详细信息
126    ///
127    /// 文档: https://socialsisteryi.github.io/bilibili-API-collect/docs/video_ranking/popular.html#获取每周必看选期详细信息
128    ///
129    /// # 参数
130    /// | 名称     | 类型     | 说明         |
131    /// | -------- | --------| ------------|
132    /// | `number` | u32     | 期数         |
133    pub async fn video_popular_series_one(
134        &self,
135        number: u32,
136    ) -> Result<BpiResponse<PopularSeriesOneData>, BpiError> {
137        self.get("https://api.bilibili.com/x/web-interface/popular/series/one")
138            .query(&[("number", number)])
139            .send_bpi("获取每周必看选期详细信息")
140            .await
141    }
142}
143
144#[cfg(test)]
145mod tests {
146    use super::*;
147    use tracing::info;
148
149    #[tokio::test]
150    async fn test_video_popular_list() {
151        let bpi = BpiClient::new();
152        let resp = bpi.video_popular_list(Some(1), Some(2)).await;
153
154        info!("{:?}", resp);
155        assert!(resp.is_ok());
156
157        let resp_data = resp.unwrap();
158        info!("code: {}", resp_data.code);
159        if let Some(data) = resp_data.data {
160            info!("no_more: {}", data.no_more);
161            info!("first item: {:?}", data.list.first());
162        }
163    }
164
165    #[tokio::test]
166    async fn test_video_popular_series_list() {
167        let bpi = BpiClient::new();
168        let resp = bpi.video_popular_series_list().await;
169
170        info!("{:?}", resp);
171        assert!(resp.is_ok());
172
173        let resp_data = resp.unwrap();
174        info!("code: {}", resp_data.code);
175        if let Some(data) = resp_data.data {
176            info!("first series: {:?}", data.list.first());
177        }
178    }
179
180    #[tokio::test]
181    async fn test_video_popular_series_one() {
182        let bpi = BpiClient::new();
183        let resp = bpi.video_popular_series_one(1).await;
184
185        info!("{:?}", resp);
186        assert!(resp.is_ok());
187
188        let resp_data = resp.unwrap();
189        info!("code: {}", resp_data.code);
190        if let Some(data) = resp_data.data {
191            info!("config: {:?}", data.config);
192            info!("first video: {:?}", data.list.first());
193        }
194    }
195}
bpi_rs/video_ranking/popular.rs

bpi_rs/video_ranking/
popular.rs
