自动化与开发者

用于读写计划的 REST API

通过 REST API 处理项目、任务、分配和依赖关系,支持权限受限的 API 密钥,并提供 OpenAPI 3.1 参考。

  • 可用
  • 免费,所有账户均包含

功能

用于自定义自动化的 Webhook 和 REST API

对于没有现成集成的场景:一有变化就发送带签名的事件,并提供读写计划的 API。

适用场景

  • 将 Planitude 连接到内部系统、ERP 或数据仓库。
  • 任务一完成或移动就触发自动化。
  • 从其他工具创建项目和任务,无需手动重复录入。
数据如何流动

从 Planitude 到 你的系统

  • 每次变更,无论来自网页应用、API、MCP 还是导入 → 带签名的事件, 从 Planitude 到 你的系统

双向

  • 项目、任务、分配和依赖关系 ↔ 通过 REST API 读写, 双向

设置

三步完成连接

  1. 创建 API 密钥

    在“个人资料 → API 密钥”中创建只读或读写密钥,可限定到某个工作区并设置到期日期。

  2. 注册 Webhook

    针对单个项目或整个工作区,从 14 种事件中选择:任务的创建、完成或移动,依赖关系,基准计划,评论等。

  3. 接收与调用

    验证每个事件的 HMAC-SHA256 签名,并调用以 OpenAPI 3.1 文档化的 REST API。

要求

方案
免费。所有 Planitude 账户都包含全部集成。
谁可以连接
每位用户使用自己的 API 密钥。项目 Webhook:所有者或编辑者;工作区 Webhook:所有者或管理员。
所需条件
一个用于接收 Webhook 的公开 HTTPS 端点;使用 API 时,需要在“个人资料 → API 密钥”中创建的密钥。

注意事项

  • Zapier、Make 和 n8n 即将推出,并将使用同一套 API 和 Webhook。
  • 密钥和已连接的应用不能删除项目或任务:删除只能在网页应用中进行。

指南与文档

关于 REST API 的常见问题

如何确认 Webhook 确实来自 Planitude?

每个请求都带有一个包含时间戳和请求体 HMAC-SHA256 签名的请求头:使用 Webhook 密钥重新计算签名,并拒绝过旧的请求。开发者文档提供了现成的示例。

通过 API 的集成可以删除项目吗?

不可以。API 密钥和已连接的应用可以读取,并在拥有写入权限时创建和更新,但删除项目和任务只能在 Web 应用中进行。

集成需要付费吗?

不需要。所有集成都包含在免费的 Planitude 中。你只需要拥有另一款工具的账号(例如 Jira、Slack 或 Microsoft 365),并遵守其条款。

如何断开集成?

随时在项目中该应用的页面点击“断开连接”即可。不会删除任何内容:任务留在 Planitude,事务和消息留在另一款工具中。已连接的 AI 应用可在“个人资料 → API 密钥”中撤销。

将 REST API 连接到 Planitude

免费注册,打开项目,在 ⋯ 菜单中选择“集成”。只需两分钟。

文中提及的商标(Jira, Azure DevOps, Slack, Telegram, Microsoft Teams, Microsoft Outlook, Microsoft PowerPoint, Microsoft Project, Microsoft Power BI, Microsoft Excel, Visual Studio Code, Google Calendar, Gemini, Apple Calendar, ChatGPT, Codex, Claude, Cursor, Zapier, Make, n8n, Primavera)归其各自所有者所有;Planitude 与其无关联,也未获得其认可。

广告让 Planitude 保持免费