创建工作流

正式环境

https://api.mingdao.com

POST

/v3/app/workflows

创建一条工作流（含触发器）。创建成功返回流程 processId。节点创建请使用 batch_create_process_nodes 工具。

触发器说明：
• triggerType=worksheet_event 工作表事件；schedule 定时。
•
• trigger.config.event 直接用后端落库取值（add/update/delete/add_or_update）。

publish=true 创建后直接尝试发布。

请求参数

Authorization

Header 参数

Body 参数application/json必填

示例

{
    "name": "string",
    "description": "string",
    "trigger": {
        "nodeAlias": "string",
        "nodeId": "string",
        "triggerType": "worksheet_event",
        "name": "string",
        "config": {
            "worksheetId": "string",
            "event": "add",
            "triggerFields": [
                "string"
            ],
            "filter": {
                "logic": "and",
                "items": [
                    {}
                ]
            },
            "loopType": "hour",
            "cron": "string",
            "startTime": "string",
            "endTime": "string",
            "customCycle": {
                "unit": "minute",
                "interval": 1,
                "weekdays": [
                    1
                ]
            },
            "dateFieldId": "string",
            "executeTime": "string",
            "offset": {
                "days": 0,
                "hours": 0,
                "minutes": 0
            },
            "samplePayload": {
                "property1": "string",
                "property2": "string"
            },
            "property1": "string",
            "property2": "string"
        }
    },
    "publish": true
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.mingdao.com/v3/app/workflows' \
--header 'HAP-Appkey: {{appkey}}' \
--header 'HAP-Sign: {{sign}}' \
--header 'Content-Type: application/json' \
--data '{
    "name": "string",
    "description": "string",
    "trigger": {
        "nodeAlias": "string",
        "nodeId": "string",
        "triggerType": "worksheet_event",
        "name": "string",
        "config": {
            "worksheetId": "string",
            "event": "add",
            "triggerFields": [
                "string"
            ],
            "filter": {
                "logic": "and",
                "items": [
                    {}
                ]
            },
            "loopType": "hour",
            "cron": "string",
            "startTime": "string",
            "endTime": "string",
            "customCycle": {
                "unit": "minute",
                "interval": 1,
                "weekdays": [
                    1
                ]
            },
            "dateFieldId": "string",
            "executeTime": "string",
            "offset": {
                "days": 0,
                "hours": 0,
                "minutes": 0
            },
            "samplePayload": {
                "property1": "string",
                "property2": "string"
            },
            "property1": "string",
            "property2": "string"
        }
    },
    "publish": true
}'

返回响应

🟢200成功

application/json

调用成功

Bodyapplication/json

示例

{
    "success": true,
    "data": {
        "processId": "string",
        "workflowId": "string",
        "published": true,
        "property1": "string",
        "property2": "string"
    },
    "error_code": 0,
    "error_msg": "string"
}

修改于 2026-06-25 10:21:03

获取触发流程列表

批量添加工作流节点