当 Python + Notion API，你就可以用「Notion 助手」轻松调试自己的小机器人

前言

本潜水员记得最开始看到 Notion 即将发布 API 的新闻就是在少数派，后来又看到有大佬发了一篇用 API 辅助记账的应用文章。很是兴奋，但苦于门槛较高一直在等方便一些的体验文章。

直到现在 API 功能已正式发布，但是仍没见新文，心痒难耐，索性直接研究了一下。踩了一些坑，同时深感测试之麻烦。要复制来去扒 ID，看报错内容，摸索对象类型，折腾下来不禁头大了半圈。

所以一气之下用 Python 撸了两个工具，顺便写上使用教程和心得，希望可以帮大家在测试 API 的时候惬意些。

本文前半部分比较繁琐，但是很推荐看完，可以参考目录跳转。

原计划用快捷指令完成这些功能，但是作者的设备目前都是 beta 版系统，快捷指令编辑的时候频出 bug 与 UI 错误。最后甚至用钟大的 JSBox 使快捷指令跳转执行 JavaScript 代码才可以成功添加记录。所以快捷指令版 Notion 助手要等正式版系统发布之后再更新了（或者有意帮忙的大佬也可以私信讨论）。

如果觉得 Python 门槛太高，可以多点赞，大家需求高的话我就封成 exe 文件再发出来（嘿嘿）。

简单介绍

拿个人最常用的吃药记录举例，最近在吃褪黑素和咖啡因片。那么我很想知道药效如何、多长时间起作用，就可以在记录时写入时间和净含量，再用 Notion 自动计算出经过的时间和服用量等数据。

不得不说这种小公式使用起来真的是很舒服，而且日常使用比 Excel 更美观易读，但是需要每次吃药都打开 Notion 手动选择数据记录下来。当然可以使用模板自动填充大部分数据，但仍需要打开 Notion 才能操作，并且还需要选择日期。如果能用手机上的快捷指令一键添加就好了。

Notion API 当然就可以实现这个功能。首先我们需要创建一个机器人，然后将机器人添加到需要进行操作的页面中，很简单，大佬的帖子写的很详细了。

但是后续的流程操作实在繁琐，以 Python 举例：（非常推荐看完下面正常方法再看辅助代码的使用教程，这样您就理解我了）

POST —— 提交数据给 Notion 的方式

如果想在某个表格里添加一项记录，你需要如下 POST 代码将数据提交给 Notion 以及一个格式正确的消息体（后面会说怎么制作）

# 在 Python 中使用 requests 模块的功能进行 GET 或 POST 操作
NotionData = requests.request(
    # POST 提交，GET 拉取
    "POST",
    # API 链接，不同操作类型的 API 链接不同，例如这个就是数据库 databases 的 API 链接
    "https://api.notion.com/v1/databases",
    # 读取消息体，消息体需要另行编辑，后文再说
    json = body,
    # 消息头，内有必要信息
    headers={
        # 设置机器人令牌，即 Notion 的机器人码
        "Authorization": "secret_kWWY0dlOI7E0nRSZbNmvxADpgFjtOD876J4W0HBn5bj", 
        # 设置 Notion 版本，目前不用改
        "Notion-Version": "2021-05-13"
        },
    )

消息体的格式与所需数据

好的，在上面的步骤中，你要根据需求自行更改三项内容：API 链接、消息体、机器人令牌。其中API 链接和机器人令牌都是易得的，消息体怎么做呢？这就比较麻烦了，看下面代码：

# 消息体的变量 body，你还记得他吗？上面的代码里就引用了它~
body = {
    # 父级信息（即你要创建的页面的上一级页面）
    "parent": {
        # 父级页面类型，如果我们想在服药记录的数据库中增加一条记录，那么新纪录是什么类型呢？
        # 答对了！是页面类型，我们创建的是记录，它展开后是一条页面，所以输入 page_id
        "type": "page_id", 
        # 注意，下面的 "page_id" 项仍需要根据你的创建项目类型变化
                # 所需要提供的 ID 就是父级页面的 ID，需要手动在链接中进行复制
                "page_id": "bbae1170539f40fea03d0d07eb5a8b60"
        },
    # 属性项，在这里决定新记录的属性是什么，这里我用服药记录举例
    "properties":{
        # 真正的属性项里有更多参数，但是很多参数都可以被忽略，Notion 会自动补全
        # 此处已经由作者处理完毕，目前有自动处理代码正在编写当中
        "数量": {
            "select": {
                "name": "2"
                }}, 
        "药名": {
            "select": {
                "name": "咖啡因片"
                }}, 
        "单份含量": {
            "select": {
                "name": "200mg"
                }}, 
        "服药日期": {
            "date": {
                # 日期可以用其他函数自动填写
                "start": "2021-08-03T05:32:00.000+08:00"}}}
    }

GET —— 让我们从 Notion 中拉取数据吧！

很好，在这部分代码中，我们需要补充：父级页面类型、父级页面 ID、编写不同的属性项

那这些神奇的数据我们需要如何获取呢？请看下面的 GET 代码，我们将用它从 Notion 上拉取页面信息~

首先我们要先在数据库中创建一条记录，然后将它的数据拉取，就可以得到最全面的数据及属性项格式了。

# 通过 Notion API 拉取数据
NotionData = requests.request(
    # POST 提交，GET 拉取
    "GET",
    # API 链接，不同操作类型的 API 链接不同
    # 在前文由于我们要创建的是数据库中的记录即页面，因此在这里我们拉取的也是页面类型 pages
    # 后面需要指明所拉取的页面 ID
    "https://api.notion.com/v1/pages/532b676181db4c13b43e1203cc69e693",
    # 前文已介绍过
    headers={
        "Authorization": "secret_kWWY0dlOI7E0nRSZbNmvxADpgFjtOD876J4W0HBn5bj", 
        "Notion-Version": "2021-05-13"
        },
    )
# 一切顺利的话，我们将拉取如下数据
# {"object":"page","id":"532b6761-81db-4c13-b43e-1203cc69e693","created_time":"2021-08-05T06:56:00.000Z","last_edited_time":"2021-08-05T10:43:00.000Z","parent":{"type":"database_id","database_id":"bbae1170-539f-40fe-a03d-0d07eb5a8b60"},"archived":false,"properties":{"数量":{"id":">dRE","type":"select","select":{"id":"03be4654-3ae8-4a71-bc3e-5d8d0f24456c","name":"4","color":"pink"}},"类别":{"id":"D`Yd","type":"select","select":{"id":"620209f6-fa99-4944-8797-5b44c9e3015d","name":"咖啡因片","color":"brown"}},"hours":{"id":"OFoK","type":"formula","formula":{"type":"string","string":"62"}},"单份含量":{"id":"TIc^","type":"select","select":{"id":"4b10b0a8-7d6e-4ff3-8cbf-737596504795","name":"200mg","color":"brown"}},"褪黑素数量":{"id":"W;[>","type":"formula","formula":{"type":"number","number":0}},"服药日期":{"id":"iahF","type":"date","date":{"start":"2021-08-03T05:32:00.000+08:00","end":null}},"minutes":{"id":"jUE[","type":"formula","formula":{"type":"string","string":"3757"}},"days":{"id":"msql","type":"formula","formula":{"type":"string","string":"2"}},"摄入量":{"id":"nyGz","type":"formula","formula":{"type":"string","string":"800mg"}},"已过时间":{"id":"v{wq","type":"formula","formula":{"type":"string","string":"已过 2 天 14 小时"}},"喝咖啡数量":{"id":"{Ah>","type":"formula","formula":{"type":"number","number":4}},"记录名":{"id":"title","type":"title","title":[]}},"url":"https://www.notion.so/532b676181db4c13b43e1203cc69e693"}

我们可以将数据复制到 JSON 在线解析网站中，可以得到如下视图。

可以发现右侧还有很多 id、type 等属性项，这些都可以后期去掉，只留下前文消息体那样的格式即可。同时右侧也展示了父级页面的类型和 ID，好方便啊（no）。