保存云手机,任务已安排。
模板参数 参数规范
- 参数来源
参数键必须从以下 API 返回的 parameter 字段中提取:
获取市场模板页面
获取个人模板页面
- 数据结构
以 JSON 对象格式提交参数:
{"key1": "value1", "key2": "value2"}最终参数值必须根据业务逻辑在使用前进行反序列化
- 通用类型参数
对于以下参数类型,请直接以相应格式传递值:
字符串:
{"name": "John"}小数/数字:
{"amount": 100.50}布尔值:
{"enabled": true}
- 媒体类型参数
对于图像 (pic) 或视频 (video) 等媒体参数,除了基本信息外,还必须包含一个固定键 "__Extra__"。示例格式:
{
"__Extra__": {
"pic": {
"name": "pic_name",
"size": 204800
},
"video": {
"name": "video_name",
"size": 204800000
}
},
"pic": "https://get.morelogin.com/prod/cloudPhoneTaskVideo/1556061681934880/1c62314c7e2b4d298abe8d5452d7c050/test.png",
"video": "morelogin://cloudfile?ids=1,2"
}如果文件已经上传到 MoreLogin 网盘,媒体或文件参数可以使用网盘文件协议作为参数值: morelogin://cloudfile?ids=1,2。ids 是网盘文件 ID 集合,多个 ID 使用英文逗号分隔。 5. 参数配置示例
以下示例演示了在使用市场模板保存套餐时如何配置 templateParameter 参数:
- 步骤 1:检索模板参数
调用市场模板 API:
GET /api/cloudphone/rpa/template/market/page
从响应中提取 parameter 字段,例如:
"parameter": "{\"videoDownloadUrl\":{\"type\":\"video\",\"extra\":{\"name\":\"Select视频","type":"视频","required":true","defaultValue":{"enabled":false}","index":1","sizeLimit":{"value":200","unit":"MB"},"formatType":["mp4","mov"]}},"videoDescription":{"type":"string","extra":{"name":"视频" “标题”",“类型”:“字符串”",“必填”:false,“字符有效”:{“启用”:true,“值”:1000},“多行”:{“启用”:true,“值”:3},“默认值”:{“启用”:false},“索引”:2}},“封面网址”:{“类型”:“图像”,“额外”:{“名称”:“封面” “图像”,“类型”:“图像”,“必填”:false,“默认值”:{“启用”:false},“索引”:3,“大小限制”:{“值”:5,“单位”:“MB”},“格式类型”:[“jpg”,“png”,“jpeg”]}},“启用AIGC”:{“类型”:“布尔值”,“附加信息”:{“名称”:“AI标签”,“类型”:“布尔值”,“必填”:false,“默认值”:{“启用”:false},“索引”:4}},“产品ID”:{“类型”:“字符串”,“附加信息”:{“名称”:“产品” ID", "type": "string", "required": false", "charValid": { "enabled": true, "value": 50}", "placeholder": "产品 ID 仅支持数字,最多 50 个字符。", "defaultValue": { "enabled": false}, "index": 5}}, "productTitle": { "type": "string", "extra": { "name": "产品标题", "type": "string", "required": false, "charValid": { "enabled": true, "value": 30}, "defaultValue": { "enabled": false}, "index": 6}}, "getLeads": { "type": "boolean", "extra": { "name": "获取Leads\",\"type\":\"boolean\",\"required\":false,\"defaultValue\":{\"enabled\":false},\"index\":7}},\"comment\":{\"type\":\"string\",\"extra\":{\"name\":\"Comment\",\"type\":\"string\",\"required\":false,\"charValid\":{\"enabled\":true,\"value\":200},\"multiline\":{\"enabled\":true,\"value\":3},\"defaultValue\":{\"enabled\":false},\"index\":8}}}"
- 步骤 2:构建参数 JSON
根据参数要求构建 JSON 对象:
{
"__Extra__": {
"videoDownloadUrl": {
"name": "video_name.mp4",
"size": 204800000
}
},
"videoDownloadUrl": "morelogin://cloudfile?ids=1,2"
}- 步骤 3:转义 JSON 字符串
将 JSON 对象转换为转义字符串格式:
"{\"__Extra__\":{\"videoDownloadUrl\":{\"name\":\"video_name.mp4\",\"size\":204800000}},\"videoDownloadUrl\":\"morelogin://cloudfile?ids=1,2\"}"
- 步骤 4:API 调用
将转义后的字符串作为 templateParameter 参数的值传递给目标 API。
模板参数在个人模板或市场模板中定义。模板中的参数定义如下:{"Test":{"extra":{"type":"string","required":true,"multiline":{"enabled":false},"name":"Test","index":1},"type":"string"}} 请求参数时,传递的参数为:{"Test":"xxxx"}
curl -i -X POST \
http://127.0.0.1:40000/api/cloudphone/rpa/onceTask/save \
-H 'Content-Type: application/json' \
-d '{
"cloudPhoneId": 1678331966138097,
"scheduleName": "test",
"templateId": 1678347487160296,
"templateParameter": "{\"keyword\": \"abc\"}",
"description": "日程安排说明"
}'{ "code": 0, "msg": "string", "requestId": "string", "data": 0 }