使用 Rust 自定义集成 Notion

2024-08-24码农

Notion 作为一款功能强大的笔记、任务管理和知识库工具，凭借其简洁的写作体验、灵活的数据库功能以及跨平台支持，赢得了众多用户的喜爱。除了丰富的预制模板和集成市场，Notion 还允许用户创建自定义集成，以满足更加个性化的需求。本文将带你深入了解 Notion 集成的世界，并使用 Rust 语言构建一个自定义集成，实现自动解析文本消息并更新 Notion 数据库的功能。

Notion 集成概述

Notion 集成可以分为两种主要类型：

预制集成: Notion 集成市场提供了大量预制集成，例如与 Slack、Calendly 等服务的连接，方便用户快速实现自动化流程。

自定义集成: 当预制集成无法满足需求时，用户可以创建自定义集成，以实现更灵活、更个性化的功能。自定义集成可以分为两种：

公开集成: 公开集成可以通过 Notion 集成市场发布，供其他用户使用。

内部集成: 内部集成仅供特定用户或团队使用，通常用于内部流程自动化或数据整合。

使用 Rust 构建自定义集成

本文将以一个简单的案例为例，介绍如何使用 Rust 构建一个自定义内部集成，实现自动解析文本消息并更新 Notion 数据库的功能。

1. 创建 Notion 集成

首先，我们需要在 Notion 中创建一个新的集成。访问 https://www.notion.so/my-integrations 页面，并按照以下步骤进行操作：

命名集成: 为集成取一个有意义的名称，例如 "Expense Tracker"。

选择工作区: 选择与集成相关的 Notion 工作区。

设置类型: 选择 "内部" 作为集成类型。

添加 Logo: 可选地添加一个 Logo 图片。

创建完成后，Notion 会生成一个集成令牌，该令牌用于访问工作区中的页面和数据库。

2. 连接页面和数据库

为了让集成能够访问特定的页面和数据库，需要在页面设置中添加集成。在目标页面或数据库的设置页面中，找到 "集成" 选项，并添加先前创建的集成。

3. 构建解析工具

在本例中，我们将使用 Rust 语言构建一个命令行工具，用于解析文本消息并更新 Notion 数据库。

use std::error::Error; use reqwest::Client; use serde_json::Value; #[tokio::main] asyncfnmain() -> Result<(), Box<dyn Error>> { // 1. 获取 Notion 集成令牌 let notion_token = std::env::var("NOTION_TOKEN")?; // 2. 获取要更新的数据库 ID let database_id = std::env::var("DATABASE_ID")?; // 3. 创建 HTTP 客户端 let client = Client::new(); // 4. 解析文本消息 let transaction_text = "Transaction: 2023-10-27 Starbucks Coffee $5.00"; let (date, vendor, amount) = parse_transaction(transaction_text)?; // 5. 构建 Notion API 请求 let request_body = json!({ "parent": { "database_id": database_id }, "properties": { "Date": { "date": { "start": date }}, "Vendor": { "rich_text": [{ "text": { "content": vendor }}] }, "Amount": { "number": amount }, } }); // 6. 发送请求到 Notion API let response = client .post(format!("https://api.notion.com/v1/pages")) .header("Authorization", format!("Bearer {}", notion_token)) .header("Content-Type", "application/json") .header("Notion-Version", "2022-02-22") .body(request_body.to_string()) .send() .await?; // 7. 处理响应 if response.status().is_success() { println!("Transaction added to Notion database."); } else { let response_text = response.text().await?; println!("Error adding transaction: {}", response_text); } Ok(()) } fnparse_transaction(text: &str) -> Result<(String, String, f64), Box<dyn Error>> { // 使用正则表达式解析文本消息 let re = regex::Regex::new(r"Transaction: (\d{4}-\d{2}-\d{2}) (.*) \$(\d+\.?\d*)")?; let captures = re.captures(text).ok_or("Invalid transaction format")?; let date = captures.get(1).unwrap().as_str().to_string(); let vendor = captures.get(2).unwrap().as_str().to_string(); let amount = captures.get(3).unwrap().as_str().parse::<f64>()?; Ok((date, vendor, amount)) }