notion-client 1.1.1

A Rust client library for the Notion 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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

use reqwest::{
    header::{self, HeaderMap, HeaderValue},
    ClientBuilder, StatusCode,
};
use serde::de::DeserializeOwned;

use crate::{objects::error::Error, NotionClientError};

use self::{
    blocks::BlocksEndpoint, comments::CommentsEndpoint, data_sources::DataSourcesEndpoint,
    databases::DatabasesEndpoint, pages::PagesEndpoint, search::SearchEndpoint,
    users::UsersEndpoint,
};

pub mod blocks;
pub mod comments;
pub mod data_sources;
pub mod databases;
pub mod pages;
pub mod search;
pub mod users;

const NOTION_URI: &str = "https://api.notion.com/v1";

pub(crate) fn parse_response<T: DeserializeOwned>(
    status: StatusCode,
    body: String,
) -> Result<T, NotionClientError> {
    if !status.is_success() {
        let error = serde_json::from_str::<Error>(&body)
            .map_err(|e| NotionClientError::FailedToDeserialize { source: e, body })?;
        return Err(NotionClientError::InvalidStatusCode { error });
    }
    serde_json::from_str::<T>(&body)
        .map_err(|e| NotionClientError::FailedToDeserialize { source: e, body })
}
const NOTION_VERSION: &str = "2026-03-11";

#[derive(Debug, Clone)]
pub struct Client {
    pub blocks: BlocksEndpoint,
    pub comments: CommentsEndpoint,
    pub data_sources: DataSourcesEndpoint,
    pub databases: DatabasesEndpoint,
    pub pages: PagesEndpoint,
    pub search: SearchEndpoint,
    pub users: UsersEndpoint,
}

impl Client {
    pub fn new(
        token: String,
        mut builder: Option<ClientBuilder>,
    ) -> Result<Self, NotionClientError> {
        let mut headers = HeaderMap::new();
        headers.insert("Notion-Version", HeaderValue::from_static(NOTION_VERSION));
        headers.insert("Content-Type", HeaderValue::from_static("application/json"));

        let mut auth_value = HeaderValue::from_str(&format!("Bearer {}", token))
            .map_err(|e| NotionClientError::InvalidHeader { source: e })?;
        auth_value.set_sensitive(true);
        headers.insert(header::AUTHORIZATION, auth_value);

        if builder.is_none() {
            builder = Some(ClientBuilder::new().default_headers(headers));
        } else {
            builder = Some(builder.unwrap().default_headers(headers));
        }

        let client = builder
            .unwrap()
            .build()
            .map_err(|e| NotionClientError::FailedToBuildRequest { source: e })?;

        Ok(Self {
            blocks: BlocksEndpoint {
                client: client.clone(),
            },
            comments: CommentsEndpoint {
                client: client.clone(),
            },
            data_sources: DataSourcesEndpoint {
                client: client.clone(),
            },
            databases: DatabasesEndpoint {
                client: client.clone(),
            },
            pages: PagesEndpoint {
                client: client.clone(),
            },
            search: SearchEndpoint {
                client: client.clone(),
            },
            users: UsersEndpoint {
                client: client.clone(),
            },
        })
    }
}