API需要连接:Notion 连接器版本 1.0.0

Notion API

通过你在“Notion 连接器”中保存的内部集成令牌调用 Notion API:搜索、读取页面、查询数据库、追加内容块。平台不持有 Notion 密钥,每次调用使用调用方组织自己的连接,按请求次数计量。

需要你的连接

该商品以你自己的账号访问上游。你的组织需要先授权或连接下列连接器,授权信息会被保存并用于调用。你可以先开通商品;在连接建立之前,网关会拒绝对它的调用。

商品介绍

使用前须先在控制台连接“Notion 连接器”。Notion-Version 请求头取自连接中填写的 API 版本,由连接器随令牌一并注入,本条目不另行声明。未经真实 Notion 工作区验证的细节:所列路径依据 2022-06-28 版本的公开文档;较新的 API 版本把数据库查询迁移到 data sources 接口,连接填写更新版本时 /v1/databases/{database_id}/query 可能不可用;集成只能访问已共享给它的页面与数据库。

价格

免费

  • 按请求:免费

按实际用量计费,开通本身不收费。调用成功后才计量。

以上为公开标价。你的组织可能有协议价,以控制台显示的价格为准。

档位

档位
notion · standard
档位标识
notion-api-standard
接口协议
HTTP 接口

如何使用

  1. 为组织开通

    在控制台为组织开通此商品,并先建立上方列出的连接;连接建立之前,网关会拒绝调用。

  2. 创建凭证

    在控制台“凭证”中创建一个凭证。密钥只显示一次,请保存到环境变量 ZGI_MARKET_KEY,并在每次请求中携带:

    Authorization: Bearer $ZGI_MARKET_KEY

    也可以使用 X-API-Key 请求头。一份凭证可以调用组织已开通的所有商品。

  3. 调用网关

    沿用厂商原有的请求与响应格式,只需把 Base URL 和密钥换成下面的值。

    Base URL
    https://market-api.zgi.im/v1/gateway/notion-api-standard
    请求示例
    curl "https://market-api.zgi.im/v1/gateway/notion-api-standard/v1/pages/{page_id}" \
      -H "Authorization: Bearer $ZGI_MARKET_KEY"

来源与审核

审核状态
审核中
许可证
未说明

审核状态是平台对上架信息的记录,不构成对上游服务质量或可用性的担保。