1. RPA
Hubstudio
  • API 使用说明文档
  • 环境管理
    • 获取环境列表
    • 创建环境
    • 更新环境
    • 更新环境代理
    • 导入Cookie
    • 导出Cookie
    • 删除环境
    • 获取随机UA
    • 清除环境本地缓存
    • 清理环境内插件缓存
    • 刷新指纹
    • 查询webglVendor和webglRenderer
    • 批量修改备注
    • 下载内核
    • 更新环境基础信息
  • 浏览器环境
    • 打开环境
    • 关闭环境
    • 关闭所有环境
    • 获取浏览器状态
    • 切换浏览器窗口
    • 获取所有打开环境
    • 获取全部屏幕(物理机的屏幕)
    • 浏览器窗口自定义排列
  • 云手机
    • 应用管理
      • APP列表(分页)\查询可安装应用列表
      • 已安装应用列表查询
      • 新增团队应用
      • app应用安装
      • APP启动
      • APP重启
      • APP停止
      • APP卸载
    • 文件管理
      • 选择本地上传文件到云手机
      • 公网文件上传文件到云手机
      • 设置keyBox
    • RPA
      • RPA模板参数填写规范
      • RPA-计划分页查询
        POST
      • RPA-个人模板分页查询
        POST
      • RPA-市场模板分页查询
        POST
      • RPA-保存计划
        POST
      • RPA-取消计划
        POST
      • RPA-执行记录分页查询
        POST
      • RPA-取消记录
        POST
      • RPA-记录详情查询
        POST
      • RPA-快速保存一次性计划
        POST
    • 云手机商品列表
      POST
    • 云手机分页列表
      POST
    • 添加云手机
      POST
    • 国家时区语言列表
      POST
    • 批量开启云手机
      POST
    • 批量关闭云手机
      POST
    • 更新代理
      POST
    • 批量获取云手机ADB状态
      POST
    • 批量更新云手机ADB状态
      POST
    • 一键新机
      POST
    • 获取一键新机状态及可用数量
      POST
    • 查询品牌机型
      POST
    • 执行shell命令
      POST
    • 修改云手机信息
      POST
    • 发送短信到云手机
      POST
    • 批量删除云手机
      POST
    • 批量修改云手机分组
      POST
  • 平台账号管理
    • 账号分页列表
    • 账号更新
    • 添加环境账号
    • 账号删除
  • 分组管理
    • 获取环境分组列表
    • 新建环境分组
    • 删除环境分组
  1. RPA

RPA模板参数填写规范

templateParameter 参数规范
1.
参数来源
参数键(key)必须从以下接口返回的 parameter 字段中提取:
获取市场模板页面接口
获取个人模板页面接口
2.
数据结构
参数以 JSON 对象格式提交:{"key1": "value1", "key2": "value2"}
最终参数值需根据业务逻辑反序列化后使用
3.
常见类型参数
以下参数类型直接按对应格式传值:
string(字符串):{"name": "John"}
decimal / number(数字):{"amount": 100.50}
boolean(布尔值):{"enabled": true}
4.
媒体类型参数
对于图片(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"
}
5.
参数配置示例
以下示例演示使用市场模板保存计划时,如何配置 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
修改于 2026-04-14 03:59:49
上一页
设置keyBox
下一页
RPA-计划分页查询
Built with