如何通过API执行Elsa Workflow中程序化创建的JSON工作流

对于程序化创建的JSON工作流（非代码优先生成的工作流），无法使用自动生成的/WorkflowName/execute端点，需调用Elsa的通用工作流执行API，具体操作如下：

1. 获取工作流定义ID #

先通过查询API获取目标工作流（Pipe1）的定义ID：

GET /v1/workflow-definitions?name=Pipe1

返回结果中的id字段即为该工作流定义的唯一标识。

2. 调用通用执行端点 #

使用获取到的工作流定义ID，发起POST请求启动工作流：

POST /v1/workflow-instances/execute

请求体（JSON格式）示例，可按需传入工作流输入参数：

{
  "workflowDefinitionId": "你的Pipe1工作流定义ID",
  "input": {
    "Param1": "Value1",
    "Param2": "Value2"
  }
}

3. 可选：直接通过工作流名称执行 #

若不想先查询ID，可直接通过工作流名称调用执行API：

POST /v1/workflow-instances/execute-by-name

请求体示例：

{
  "workflowName": "Pipe1",
  "input": {
    "Param1": "Value1"
  }
}

注意：若存在多个同名但不同版本的工作流，该端点默认执行最新版本。

4. 验证执行状态 #

执行成功后，API会返回工作流实例信息，包含id（实例ID）、status（执行状态）等字段。可通过以下API查询实例执行详情：

GET /v1/workflow-instances/你的实例ID

内容的提问来源于stack exchange，提问作者Kanak Sharma