关于Notion API webhooks中page.created事件内容的技术问询

page.created事件的Webhook payload不会直接返回页面标题、自定义属性这类完整内容，仅包含事件元数据和基础关联信息。你需要拿到payload里的页面ID后，再调用Notion的Retrieve a page接口获取完整属性。

实际page.created事件Payload示例 #

{
  "object": "event",
  "type": "page_created",
  "event_id": "e1234567-89ab-cdef-ghij-klmnopqrstuv",
  "event_time": 1620000000000,
  "workspace_id": "w12345678-90ab-cdef-ghij-klmnopqrstuv",
  "data": {
    "page_id": "p12345678-90ab-cdef-ghij-klmnopqrstuv",
    "parent": {
      "type": "database_id",
      "database_id": "d12345678-90ab-cdef-ghij-klmnopqrstuv"
    },
    "created_by": {
      "object": "user",
      "id": "u12345678-90ab-cdef-ghij-klmnopqrstuv"
    },
    "created_time": "2021-05-03T12:00:00.000Z"
  }
}

关键字段说明 #

• data.page_id：新创建页面的唯一标识，是后续获取完整页面信息的核心参数
• data.parent.database_id：页面所属的数据库ID，用于确认事件来源是否为目标数据库
• created_by/created_time：仅提供创建者ID和创建时间的基础元数据

补充说明 #

• 不止page.created，包括page.updated这类事件，Webhook也只会返回变更的基础标识（比如page.updated会列出修改的属性字段名），不会返回完整属性值，必须调用页面详情接口拉取
• 开发阶段可以用本地穿透工具临时暴露本地服务，快速测试Webhook的实际Payload，无需提前部署正式环境

内容的提问来源于stack exchange，提问作者Diego Martinez