bpi-rs 0.2.0

Bilibili API client library for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

// 专栏点赞&投币&收藏
//
// [查看 API 文档](https://github.com/Yuelioi/bilibili-API-collect/tree/cfc5fddcc8a94b74d91970bb5b4eaeb349addc47/docs/article/action.md)

use crate::BilibiliRequest;
use crate::article::ArticleClient;
use crate::article::params::{ArticleCoinParams, ArticleFavoriteParams, ArticleLikeParams};
use crate::response::BpiResult;

const LIKE_ENDPOINT: &str = "https://api.bilibili.com/x/article/like";
const COIN_ENDPOINT: &str = "https://api.bilibili.com/x/web-interface/coin/add";
const FAVORITE_ADD_ENDPOINT: &str = "https://api.bilibili.com/x/article/favorites/add";
const FAVORITE_DEL_ENDPOINT: &str = "https://api.bilibili.com/x/article/favorites/del";

/// 投币响应数据

#[derive(Debug, Clone, serde::Deserialize)]
pub struct CoinResponseData {
    /// 是否点赞成功 true：成功 false：失败 已赞过则附加点赞失败
    pub like: bool,
}

impl<'a> ArticleClient<'a> {
    /// Likes or unlikes an article and returns the canonical payload result.
    pub async fn like(&self, params: ArticleLikeParams) -> BpiResult<Option<serde_json::Value>> {
        let csrf = self.client.csrf()?;

        self.client
            .post(LIKE_ENDPOINT)
            .form(&params.form_pairs(&csrf))
            .send_bpi_optional_payload("article.like")
            .await
    }

    /// Gives coins to an article and returns the canonical payload result.
    pub async fn coin(&self, params: ArticleCoinParams) -> BpiResult<CoinResponseData> {
        let csrf = self.client.csrf()?;

        self.client
            .post(COIN_ENDPOINT)
            .form(&params.form_pairs(&csrf))
            .send_bpi_payload("article.coin")
            .await
    }

    /// Favorites an article and returns the canonical payload result.
    pub async fn favorite(
        &self,
        params: ArticleFavoriteParams,
    ) -> BpiResult<Option<serde_json::Value>> {
        let csrf = self.client.csrf()?;

        self.client
            .post(FAVORITE_ADD_ENDPOINT)
            .form(&params.form_pairs(&csrf))
            .send_bpi_optional_payload("article.favorite")
            .await
    }

    /// Removes an article from favorites and returns the canonical payload result.
    pub async fn unfavorite(
        &self,
        params: ArticleFavoriteParams,
    ) -> BpiResult<Option<serde_json::Value>> {
        let csrf = self.client.csrf()?;

        self.client
            .post(FAVORITE_DEL_ENDPOINT)
            .form(&params.form_pairs(&csrf))
            .send_bpi_optional_payload("article.unfavorite")
            .await
    }
}

#[cfg(test)]
mod tests {}