bpi_rs/article/
articles.rs

1//! 文集基本信息
2//!
3//! [查看 API 文档](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/article/articles.md)
4
5use crate::article::models::{ ArticleAuthor, ArticleCategory, ArticleStats };
6use crate::{ BilibiliRequest, BpiClient, BpiError, BpiResponse };
7use serde::{ Deserialize, Serialize };
8
9/// 文集基本信息数据
10#[derive(Debug, Clone, Serialize, Deserialize)]
11pub struct ArticlesData {
12    /// 文集概览
13    pub list: ArticleList,
14    /// 文集内的文章列表
15    pub articles: Vec<ArticleItem>,
16    /// 文集作者信息
17    pub author: ArticleAuthor,
18    /// 作用尚不明确 结构与data.articles[]中相似
19    pub last: ArticleItem,
20    /// 是否关注文集作者 false：未关注 true：已关注 需要登录(Cookie) 未登录为false
21    pub attention: bool,
22}
23
24/// 文集概览
25#[derive(Debug, Clone, Serialize, Deserialize)]
26pub struct ArticleList {
27    /// 文集rlid
28    pub id: i64,
29    /// 文集作者mid
30    pub mid: i64,
31    /// 文集名称
32    pub name: String,
33    /// 文集封面图片url
34    pub image_url: String,
35    /// 文集更新时间 时间戳
36    pub update_time: i64,
37    /// 文集创建时间 时间戳
38    pub ctime: i64,
39    /// 文集发布时间 时间戳
40    pub publish_time: i64,
41    /// 文集简介
42    pub summary: String,
43    /// 文集字数
44    pub words: i64,
45    /// 文集阅读量
46    pub read: i64,
47    /// 文集内文章数量
48    pub articles_count: i32,
49    /// 1或3 作用尚不明确
50    pub state: i32,
51    /// 空 作用尚不明确
52    pub reason: String,
53    /// 空 作用尚不明确
54    pub apply_time: String,
55    /// 空 作用尚不明确
56    pub check_time: String,
57}
58
59/// 文章项目
60#[derive(Debug, Clone, Serialize, Deserialize)]
61pub struct ArticleItem {
62    /// 专栏cvid
63    pub id: i64,
64    /// 文章标题
65    pub title: String,
66    /// 0 作用尚不明确
67    pub state: i32,
68    /// 发布时间 秒时间戳
69    pub publish_time: i64,
70    /// 文章字数
71    pub words: i64,
72    /// 文章封面
73    pub image_urls: Vec<String>,
74    /// 文章标签
75    pub category: ArticleCategory,
76    /// 文章标签列表
77    pub categories: Vec<ArticleCategory>,
78    /// 文章摘要
79    pub summary: String,
80    // 文章状态数信息
81    pub stats: Option<ArticleStats>,
82    /// 是否点赞 0：未点赞 1：已点赞 需要登录(Cookie) 未登录为0
83    pub like_state: Option<i32>,
84}
85
86/// 作者大会员状态
87#[derive(Debug, Clone, Serialize, Deserialize)]
88pub struct AuthorVip {
89    /// 大会员类型
90    pub r#type: i32,
91    /// 大会员状态
92    pub status: i32,
93    /// 到期时间
94    pub due_date: i64,
95    /// 支付类型
96    pub vip_pay_type: i32,
97    /// 主题类型
98    pub theme_type: i32,
99    /// 标签
100    pub label: Option<serde_json::Value>,
101}
102
103impl BpiClient {
104    /// 获取文集基本信息
105    ///
106    /// # 参数
107    /// | 名称   | 类型  | 说明              |
108    /// | ------ | ----- | ----------------- |
109    /// | `id`   | i64   | 文集 rlid (必要)  |
110    ///
111    /// # 文档
112    /// [获取文集基本信息](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/article/articles.md#获取文集基本信息)
113    pub async fn article_articles_info(
114        &self,
115        id: i64
116    ) -> Result<BpiResponse<ArticlesData>, BpiError> {
117        self
118            .get("https://api.bilibili.com/x/article/list/web/articles")
119            .query(&[("id", id.to_string())])
120            .send_bpi("获取文集基本信息").await
121    }
122}
123
124#[cfg(test)]
125mod tests {
126    use super::*;
127
128    #[tokio::test]
129    async fn test_get_articles_info() -> Result<(), Box<BpiError>> {
130        let bpi = BpiClient::new();
131
132        let rlid = 207146;
133
134        let result = bpi.article_articles_info(rlid).await?;
135        let data = result.into_data()?;
136        tracing::info!("{:#?}", data);
137
138        assert!(!data.list.name.is_empty());
139        assert!(!data.articles.is_empty());
140        assert!(!data.author.name.is_empty());
141
142        Ok(())
143    }
144}
bpi_rs/article/articles.rs

bpi_rs/article/
articles.rs
