botrs 0.12.1

A Rust QQ Bot framework based on QQ Guild Bot API
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

use crate::api::{BotApi, resource};
use crate::error::Result;
use crate::token::Token;
use tracing::debug;

impl BotApi {
    /// Recalls (deletes) a message.
    pub async fn recall_message(
        &self,
        token: &Token,
        channel_id: &str,
        message_id: &str,
        hidetip: Option<bool>,
    ) -> Result<()> {
        debug!("Recalling message {} in channel {}", message_id, channel_id);
        let params = Self::recall_hide_tip_query(hidetip);
        let path = resource::channel_message(channel_id, message_id);
        self.http.delete(token, &path, Some(&params)).await?;
        Ok(())
    }

    /// Recalls a C2C message.
    pub async fn retract_c2c_message(
        &self,
        token: &Token,
        openid: &str,
        message_id: &str,
        hidetip: Option<bool>,
    ) -> Result<()> {
        debug!("Retracting C2C message {} for {}", message_id, openid);
        self.retract_open_message(token, resource::c2c_message(openid, message_id), hidetip)
            .await
    }

    /// Recalls a group message.
    pub async fn retract_group_message(
        &self,
        token: &Token,
        group_openid: &str,
        message_id: &str,
        hidetip: Option<bool>,
    ) -> Result<()> {
        debug!(
            "Retracting group message {} for {}",
            message_id, group_openid
        );
        self.retract_open_message(
            token,
            resource::group_message(group_openid, message_id),
            hidetip,
        )
        .await
    }

    pub(crate) async fn retract_open_message(
        &self,
        token: &Token,
        path: String,
        hidetip: Option<bool>,
    ) -> Result<()> {
        let params = Self::hide_tip_query(hidetip.unwrap_or(false));
        self.http.delete(token, &path, params.as_ref()).await?;
        Ok(())
    }
}