跳到主要内容

Sprint 347 — API v2：RESTful 接口 + Webhook 外部集成

· 阅读需 2 分钟

Pragma 正式发布开发者 API — REST 接口、作用域 API 密钥、实时 Webhook 推送，以及内置文档页面 /developer。

更新内容​

API v2 — RESTful 接口​

外部工具和脚本现可直接与 Pragma 通信：

接口说明
GET /api/v2/workspace工作区信息与统计
GET /api/v2/signals列出信号收件箱中的信号
POST /api/v2/signals写入新信号
GET /api/v2/leads列出线索（支持分页）
GET /api/v2/leads/{id}获取单条线索
POST /api/v2/leads创建线索
GET /api/v2/contacts列出联系人
GET /api/v2/contacts/{id}获取单条联系人

精细化 API 密钥作用域​

每个 API 密钥只获得所需的最小权限：

  • signals:read / signals:ingest
  • leads:read / leads:write
  • contacts:read / contacts:write
  • deals:read
  • webhooks:read / webhooks:write

Webhook — 实时事件推送​

注册 Webhook 后，以下事件将即时触发 POST 请求：

  • signal.created — 新信号进入收件箱
  • lead.created / lead.updated
  • deal.updated
  • message.created
  • billing.activated

所有 Webhook 均通过 HMAC-SHA256 签名（X-Pragma-Signature），失败时最多重试 5 次。

设置中的开发者 API 管理​

在 设置 → Developer API 中可直接在浏览器中：

  • 创建 API 密钥（选择作用域）并吊销
  • 注册 Webhook（配置目标 URL 和事件类型）
  • 安全复制新密钥（仅显示一次）

/developer 开发者文档​

完整的 API 文档，包含代码示例、curl 命令及 Zapier 集成指南。

为什么重要​

API v2 是 Sprint 343（Zapier 官方应用）的基础，将 Pragma 接入拥有超过 7,000 个应用的 Zapier 生态系统以及数百万 Make 用户群。