notionrs 0.25.0

A Notion API client that provides type-safe request serialization and response deserialization
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

/// <https://developers.notion.com/reference/retrieve-page-markdown>
#[derive(Debug, Default, notionrs_macro::Setter)]
pub struct GetPageMarkdownClient {
    /// The reqwest http client
    pub(crate) reqwest_client: reqwest::Client,

    /// The ID of the page (or block) to retrieve as markdown.
    /// Non-navigable block IDs from truncated responses can be passed here
    /// to fetch their subtrees.
    pub(crate) page_id: Option<String>,

    /// Whether to include meeting note transcripts. Defaults to false.
    /// When true, full transcripts are included; when false, a placeholder
    /// with the meeting note URL is shown instead.
    pub(crate) include_transcript: Option<bool>,
}

impl GetPageMarkdownClient {
    pub async fn send(
        self,
    ) -> Result<notionrs_types::object::page_markdown::PageMarkdownResponse, crate::error::Error>
    {
        let page_id = self.page_id.ok_or(crate::error::Error::RequestParameter(
            "`page_id` is not set.".to_string(),
        ))?;

        let url = format!("https://api.notion.com/v1/pages/{}/markdown", page_id);

        let request = self.reqwest_client.get(url);
        let request = if let Some(include_transcript) = self.include_transcript {
            request.query(&[("include_transcript", include_transcript)])
        } else {
            request
        };

        let response = request
            .send()
            .await
            .map_err(|e| crate::error::Error::Network(e.to_string()))?;

        if !response.status().is_success() {
            return Err(crate::error::Error::try_from_response_async(response).await);
        }

        let body = response
            .bytes()
            .await
            .map_err(|e| crate::error::Error::BodyParse(e.to_string()))?;

        let page_markdown = serde_json::from_slice::<
            notionrs_types::object::page_markdown::PageMarkdownResponse,
        >(&body)?;

        Ok(page_markdown)
    }
}