Skip to main content

如何运行动作

我们的动作端点让您能够以编程方式在产品中执行 Zapier 驱动的动作。这一点特别适用于提供原生自动化功能，而无需用户自行创建完整的流程。

本指南将逐步说明如何使用 API 启动和监控动作执行。阅读完毕后，您将学会如何触发任何 Zapier 驱动的动作（如发送电子邮件、更新电子表格或在其他应用中创建记录），并从您的应用中获取结果。

什么是动作执行？​

动作执行 表示 Zapier 工作流中一个动作步骤的单次运行。当您调用动作执行 API 时，Zapier 会处理动作逻辑并返回一个 run_id，用于查询执行状态和结果。

示例 / 演示​

先决条件​

在开始前，请确保以下条件已满足：

  • 您拥有访问 公共 Zapier 集成 的权限。
  • 您已注册应用并完成身份验证，以使用 API。
  • 您的集成中至少有一个 动作 已配置，包括必要字段，并在 Zapier UI 或通过 API 测试了样本数据。

第 1 步：触发动作执行​

要触发动作，请向 /v2/action-runs/ 发送 POST 请求。

请求示例​

POST https://api.zapier.com/v2/action-runs/
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "action": "action_id",
  "authentication": "authentication_id",
  "input": {
    "email": "user@example.com",
    "message": "Hello from Powered by Zapier!"
  }
}

参数​

字段类型描述
actionstring要运行的动作唯一标识符。
authenticationstring运行动作所需的身份验证 ID。
inputobject动作所需输入字段的关键值对。

响应示例​

{
  "data": {
    "type": "run",
    "id": "arun_abc123"
  }
}

您可以使用此执行的 id 来轮询其状态和结果。

第 2 步：检索动作执行结果​

要查看动作执行结果，请向 /v2/action-runs/ 发送 GET 请求。

请求示例​

GET https://api.zapier.com/v2/action-runs/arun_abc123/
Authorization: Bearer YOUR_ACCESS_TOKEN

可能的状态​

状态含义
queued执行正在等待处理。
running动作当前正在执行中。
success执行成功完成。
error执行过程中发生错误。

响应示例​

{
  "data": {
    "type": "run",
    "run_id": "arun_abc123",
    "status": "success",
    "results": {
      // 动作结果数据
    },
    "errors": []
  }
}

如果执行成功，results 字段将包含动作的结果。您可以直接向用户展示这些结果，或据此触发后续流程。