管理 API 集成 #

我们的 API 目前正处于公开测试阶段! 有了它,你可以将其他软件连接到 Notion,在你的工作区内实现自动化操作!

想开始使用 Notion 的 API 建立你自己强大的工作流程吗?请访问我们的开发者中心 (opens new window),了解更多相关信息。

Notion API (opens new window)

在你的工作区管理集成(integrations) #

WARNING

👉 注意只有工作区的管理员才能访问 Settings & Members 设置和成员 菜单中的 integrations

  • 在你的左侧边栏点击 Settings & Members 设置和成员,然后进入integrations 页面。
  • 在这里,你会看到为这个工作区安装的所有现有集成,每个集成是被谁添加的,以及每个集成的添加日期。

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/9c8ee41a-5b69-4eb3-ac26-f470ec4fcc94/Integration_Menu.png

  • 点击集成旁边的···,可以看到其他选项。
    • 检索该集成的API令牌(仅内部集成)。
    • 访问集成开发者的网站或联系他们的支持(只限于公共集成)。
    • 断开该集成的连接

从开发者那里安装公共集成 #

###直接从合作伙伴平台安装

Notion已经与一些服务机构直接合作(如Zapier (opens new window), Typeform, 和Automate.io (opens new window))。你可以直接通过他们的网站将我们合作伙伴的公共集成添加到你的工作区。

  • 在合作伙伴平台的应用菜单中搜索 "Notion "并添加它。
  • 在产生的认证菜单中,合作伙伴的集成会要求你允许访问你的工作区。
  • 集成是针对工作区的! 如果需要,点击右上方的工作区名称,切换到另一个工作区。然后,按选择页面

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/ba9b9afa-b177-4bea-844b-332c50d0f0d4/OAuth.png

  • 现在,你会看到所选工作区的所有页面的列表。选择你希望集成能够访问的页面,然后按 "允许访问"。

👉 注意你也可以在Notion中添加和删除你的页面上的集成。[这里有说明 →](https://www.notion.so/Copy-of-Add-and-manage-integrations-with-the-API-0dcfed76bf00488db44c5bb981ddba5f)

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/514b4cea-ada0-42f9-8082-5c9b3b61ae35/OAuth.gif (opens new window)

  • 一旦你完成了认证,你会在你的工作区的 "设置和成员 "菜单→"整合 "中看到这个整合。
  • 点击集成名称旁边的···菜单,访问开发商的网站,联系开发商的支持团队,或者从你的工作区断开集成。

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/f013412e-5f16-4129-86a9-08f2b85379b3/Integration_menu_-_Automate.io.png

🎒 提示想看看一些合作伙伴集成的操作吗?请看这个[指南→](https://www.notion.so/guides/connect-tools-to-notion-api)

###通过内部集成令牌安装

一些合作伙伴平台需要一个内部集成令牌,以便链接到您的工作区。

  • 在这种情况下,首先按照这些说明 (opens new window)为你的工作区创建一个相应的内部集成。
  • 一旦你创建了内部集成,在你的侧边栏导航到 Settings & Members 设置和成员,然后是 "集成 "标签。
  • 点击你想链接到合作伙伴平台的现有内部集成旁边的---菜单,然后按复制内部集成令牌

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/5391ea33-87e7-4e0d-85b1-6a7da50d0982/Integration_menu_-_Token.png

  • 把这个内部集成令牌粘贴到合作伙伴平台的设置表格的相应字段中。这允许他们将他们的服务与你的内部集成联系起来。

👉 注意 Notion不支持合作伙伴集成的故障排除。请将任何反馈和问题交给各自的合作伙伴的支持团队。

在页面中添加集成 #

用API构建的集成遵循一个类似于Notion用户的共享权限 (opens new window)的权限系统。为了在你的工作区使用一个集成,你需要把它添加到它将被激活的特定页面。

👉 注意只有管理员能够创建和管理一个工作区的集成。然而,一旦工作区存在一个整合,所有成员将能够将其添加到页面。

  • 导航到相关页面,点击右上方的 Share 分享按钮。
  • 点击 "添加人员、电子邮件、小组或集成"。

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/5f154f3b-2646-41ec-9682-29edcdecc00a/Integration_-_Share_1.png

  • 在弹出的窗口中,选择你想添加到这个页面的集成。你将只看到为这个工作区创建并与之相关的整合。

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/1ee8ede3-bfd1-4efa-ba8d-eecd819e2052/Integration_-_Share_2.png

  • 该集成现在将出现在该页面的 Shared 共享菜单中。

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/c8ede42e-0297-4a54-be40-bb0cf75c0548/Integration_-_Share_3.png

  • 如果你想从一个页面上删除一个集成,点击它的名字旁边的下拉菜单,然后按`删除'。

常见问题解答 #

关于使用Notion的API时的技术常见问题,请参见我们的开发者常见问题 (opens new window)

  • **我在哪里可以找到我的API令牌?

    只有工作区的管理员可以访问API菜单。如果你不是管理员,请联系你团队中的管理员,为你生成一个API令牌。

    作为一个管理员,点击左上角的 Settings & Members 设置和成员。在下一个窗口中,点击 "整合 "标签。

    你将能够在其名称旁边的---菜单中检索到现有内部集成的令牌。要添加一个新的内部集成,请按照说明这里→ (opens new window)

  • **我在哪里可以找到API文档?

    我们的官方API文档可在developer.notion.com (opens new window)找到。

  • **Notion有什么样的API?

    我们正在建立一个REST API,这是开发人员最常选择的API类型。RESTful API是一种应用程序接口(API)的架构风格,它使用HTTP请求来访问和使用数据。这些数据可用于读取、更新、创建和删除数据。

  • **我需要付费才能访问Notion的API吗?

    不,该API对所有用户都是免费的! 下面是我们的**定价指南 (opens new window)**的详细信息。

  • **有哪些合作伙伴可供集成?

    关于新合作伙伴的更新,请在Twitter上关注我们:@NotionHQ和@NotionAPI! 如果你有兴趣成为我们的合作伙伴,请申请这里 (opens new window)

  • 我有一个关于合作伙伴整合的问题和/或反馈要分享。你能帮忙吗?

    Notion不支持合作伙伴集成的故障排除。请将任何反馈和问题提交给各自合作伙伴的支持团队。

    要找到开发商的信息,请到你的 "设置和成员 "菜单,然后到 "集成 "标签。点击任何公共集成旁边的···按钮,你会看到访问开发商网站和联系他们的支持团队的选项。

  • **你有一个未来将与之整合的合作伙伴的名单吗?

    谢谢你的提问! 虽然我们目前没有任何细节可以分享,但你可以期待新的合作伙伴的整合,因为它们是可用的。请在Twitter上关注我们@NotionHQ和@NotionAPI的更新和公告!

  • 我有兴趣成为一个合作伙伴。我怎样才能申请呢

    谢谢你的兴趣! 你可以申请成为合作伙伴[这里](https://notionup.typeform.com/to/kViev734)。

  • 我刚刚提交了一份成为合作伙伴的申请。我什么时候能收到回音?

    非常感谢您的耐心等待。我们目前正经历着大量的请求。请允许我们在7天之内给你答复。如果在此期间还有什么我可以帮助的,请告诉我

  • **我怎样才能了解Notion API的新功能和公告?

    在Twitter上关注我们@NotionHQ和@NotionAPI的更新和公告!