RPA模板参数填写规范

templateParameter 参数规范

参数来源
参数键（key）必须从以下接口返回的 parameter 字段中提取：

获取市场模板页面接口

获取个人模板页面接口

数据结构

参数以 JSON 对象格式提交：{"key1": "value1", "key2": "value2"}

最终参数值需根据业务逻辑反序列化后使用

常见类型参数
以下参数类型直接按对应格式传值：

string（字符串）：{"name": "John"}

decimal / number（数字）：{"amount": 100.50}

boolean（布尔值）：{"enabled": true}

媒体类型参数
对于图片（pic）、视频（video）等媒体参数，除基础信息外，必须包含固定键 Extra。示例格式如下：

{
    "__Extra__": {
        "pic": {
            "name": "pic_name",
            "size": 204800
        },
        "video": {
            "name": "video_name",
            "size": 204800000
        }
    },
    "pic": "https://xxxxx.com/test.png",
    "video": "https://xxxxx.com/baby.mp4"
}

参数配置示例
以下示例演示使用市场模板保存计划时，如何配置 templateParameter 参数：

步骤 1：获取模板参数
调用市场模板接口：

GET http://127.0.0.1:6873/api/v1/cloud-mobile/rpa/template/market/page

从响应中提取 parameter 字段，例如：

{
    "code": 0,
    "msg": "Success",
    "requestId": "d8068c6d-e352-42bf-be4a-bcd1ec4fdf4c",
    "timestamp": 1775117889854,
    "data": {
        "list": [
            {
                "id": 7,
                "sort": 0,
                "title": "TikTok 智能养号",
                "type": 1,
                "description": "支持自定义编排流程",
                "parameter": "{\"点赞概率\":{\"extra\":{\"type\":\"integer\",\"required\":false,\"name\":\"点赞概率\",\"index\":3,\"numberRange\":{\"enabled\":true,\"min\":0,\"max\":95},\"defaultValue\":{\"enabled\":true,\"value\":25}},\"type\":\"integer\",\"default\":25},\"关注概率\":{\"extra\":{\"type\":\"integer\",\"required\":false,\"name\":\"关注概率\",\"index\":2,\"numberRange\":{\"enabled\":true,\"min\":0,\"max\":95},\"defaultValue\":{\"enabled\":true,\"value\":0}},\"type\":\"integer\",\"default\":0},\"查看评论概率\":{\"extra\":{\"type\":\"integer\",\"required\":false,\"name\":\"查看评论概率\",\"index\":4,\"numberRange\":{\"enabled\":true,\"min\":0,\"max\":95},\"defaultValue\":{\"enabled\":true,\"value\":5}},\"type\":\"integer\",\"default\":5},\"预估浏览视频数量\":{\"extra\":{\"type\":\"integer\",\"required\":true,\"name\":\"预估浏览视频数量\",\"index\":1,\"defaultValue\":{\"enabled\":true,\"value\":130},\"numberRange\":{\"enabled\":true,\"min\":1,\"max\":1000}},\"type\":\"integer\",\"default\":130}}",
                "updateDate": "2026-03-26T10:24:39",
                "appIconUrls": [
               "http://xxxxx.com/3f86a248e7726c8b05369322584ee087.png"
                ],
                "author": "赵"
            },
            {
                "id": 6,
                "sort": 0,
                "title": "TikTok 发布视频",
                "type": 1,
                "description": "支持自定义编排流程",
                "parameter": "{\"选择视频\":{\"extra\":{\"type\":\"video\",\"required\":true,\"sizeLimit\":{\"value\":300,\"unit\":\"MB\"},\"formatType\":[\"mp4\",\"mov\"],\"name\":\"选择视频\",\"index\":1},\"type\":\"video\"},\"视频文案\":{\"extra\":{\"type\":\"string\",\"required\":false,\"multiline\":{\"enabled\":true,\"value\":3},\"name\":\"视频文案\",\"charValid\":{\"enabled\":true,\"value\":1000},\"index\":2,\"placeholder\":\"为视频添加描述性的文案。\"},\"type\":\"string\"},\"封面图片\":{\"extra\":{\"type\":\"image\",\"required\":false,\"sizeLimit\":{\"value\":5,\"unit\":\"MB\"},\"formatType\":[\"jpg\",\"png\",\"jpeg\"],\"name\":\"封面图片\",\"index\":3},\"type\":\"image\"},\"AI标签\":{\"extra\":{\"type\":\"boolean\",\"required\":false,\"name\":\"AI标签\",\"index\":4,\"placeholder\":\"添加后，您的内容将显示一条标签，表明它是 AI 生成或 AI 编辑的内容。\"},\"type\":\"boolean\"},\"获取线索\":{\"extra\":{\"type\":\"boolean\",\"required\":false,\"name\":\"获取线索\",\"index\":5,\"placeholder\":\"在视频中添加“获取线索”组件？需要已启用“获取线索”功能的商业账号。\"},\"type\":\"boolean\"},\"商品ID\":{\"extra\":{\"type\":\"string\",\"required\":false,\"multiline\":{\"enabled\":true,\"value\":2},\"name\":\"商品ID\",\"charValid\":{\"enabled\":true,\"value\":50},\"index\":6,\"placeholder\":\"选填。输入商品 ID 以在视频中挂载商品。如果账号不支持此功能，发布将会失败。\"},\"type\":\"string\"},\"商品标题\":{\"extra\":{\"type\":\"string\",\"required\":false,\"multiline\":{\"enabled\":true,\"value\":2},\"name\":\"商品标题\",\"charValid\":{\"enabled\":true,\"value\":30},\"index\":7,\"placeholder\":\"选填。输入小黄车对应的商品标题或描述，最多 30 个字符。\"},\"type\":\"string\"},\"评论\":{\"extra\":{\"type\":\"string\",\"required\":false,\"multiline\":{\"enabled\":true,\"value\":3},\"name\":\"评论\",\"charValid\":{\"enabled\":true,\"value\":200},\"index\":8,\"placeholder\":\"视频发布成功后自动发布一条评论，最多 200 个字符。\"},\"type\":\"string\"}}",
                "updateDate": "2026-03-25T20:24:13",
                "appIconUrls": [
              "http://xxxxx.com/3f86a248e7726c8b05369322584ee087.png"
                ],
                "author": "赵"
            },
            {
                "id": 4,
                "sort": 0,
                "title": "Instagram 智能养号",
                "type": 1,
                "description": "支持自定义编排流程",
                "parameter": "{\"Probability of liking\":{\"extra\":{\"type\":\"integer\",\"required\":false,\"name\":\"Probability of liking\",\"index\":3,\"numberRange\":{\"enabled\":true,\"min\":0,\"max\":90},\"defaultValue\":{\"enabled\":true,\"value\":5}},\"type\":\"integer\",\"default\":5},\"Probability of following\":{\"extra\":{\"type\":\"integer\",\"required\":false,\"name\":\"Probability of following\",\"index\":2,\"numberRange\":{\"enabled\":true,\"min\":0,\"max\":90},\"defaultValue\":{\"enabled\":true,\"value\":5}},\"type\":\"integer\",\"default\":5},\"Probability of viewing comments\":{\"extra\":{\"type\":\"integer\",\"required\":false,\"name\":\"Probability of viewing comments\",\"index\":4,\"numberRange\":{\"enabled\":true,\"min\":0,\"max\":90},\"defaultValue\":{\"enabled\":true,\"value\":5}},\"type\":\"integer\",\"default\":5},\"Estimated number of videos browsed\":{\"extra\":{\"type\":\"integer\",\"required\":true,\"name\":\"Estimated number of videos browsed\",\"index\":1,\"defaultValue\":{\"enabled\":true,\"value\":15},\"numberRange\":{\"enabled\":true,\"min\":1,\"max\":1000}},\"type\":\"integer\",\"default\":15}}",
                "updateDate": "2026-03-25T10:56:10",
                "appIconUrls": [
              "https://xxxxx.com/2e477dd8f50a42d3b116083247e7806d.png"
                ],
                "author": "Owen"
            },
            {
                "id": 5,
                "sort": 1,
                "title": "Instagram发布视频-Plus",
                "type": 1,
                "description": "支持自定义编排流程",
                "parameter": "{\"videoDownloadUrl\":{\"type\":\"video\",\"extra\":{\"name\":\"Select Video\",\"type\":\"video\",\"required\":true,\"defaultValue\":{\"enabled\":false},\"index\":1,\"sizeLimit\":{\"value\":200,\"unit\":\"MB\"},\"formatType\":[\"mp4\",\"mov\"]}},\"videoDescription\":{\"type\":\"string\",\"extra\":{\"name\":\"Video Caption\",\"type\":\"string\",\"required\":false,\"charValid\":{\"enabled\":true,\"value\":1000},\"multiline\":{\"enabled\":true,\"value\":3},\"defaultValue\":{\"enabled\":false},\"index\":2}},\"enableAddAILabel\":{\"type\":\"boolean\",\"extra\":{\"name\":\"AI Label\",\"type\":\"boolean\",\"required\":false,\"defaultValue\":{\"enabled\":false},\"index\":4}}}",
                "updateDate": "2026-04-01T17:07:44",
                "appIconUrls": [
              "https://xxxxx.com/2e477dd8f50a42d3b116083247e7806d.png"
                ],
                "author": "Owen"
            }
        ],
        "total": 4
    }
}

步骤 2：构建参数 JSON
根据参数要求构造 JSON 对象：

{
  "__Extra__": {
    "videoDownloadUrl": {
      "name": "video_name.mp4",
      "size": 204800000
    }
  },
  "videoDownloadUrl": "https://xxxxx.com/baby.mp4"
}

转义 JSON 字符串
将 JSON 对象转换为转义后的字符串格式：

"{\"__Extra__\": {\"videoDownloadUrl\": {\"name\": \"video_name.mp4\",\"size\": 204800000}},\"videoDownloadUrl\": \"https://xxxxx.com/baby.mp4\"}"

步骤 4：调用接口
将转义后的字符串作为 templateParameter 参数的值，传入目标接口

接口信息
接口地址：POST /api/v1/cloud-mobile/rpa/task/save