阿里云首页 机器人流程自动化RPA

createServiceTask

调用地址:api-rpa.aliyun.com/rpa/openapi/task/createServiceTask

调用方式:POST

返回类型:JSON

接口说明:创建服务型任务

请求参数

名称

类型

是否必选

示例值

描述

appId

String

fb6a99a1-d8bd-46ee-8bed-2ed9cb5a0c0d

应用唯一标识符

appParams

Json数组

[{"name":"参数1","value":""},{"name":"参数2","value":""}]

name:参数名称

value:参数值

clientId

String

5E77DA4EB87BCFB62A8B9527626A47F4

机器人唯一标识符

callbackUrl

String

回调url

返回参数

返回参数公共字段请查阅返回结果,返回参数中的 data 字段说明如下:

名称

类型

示例值

描述

taskId

String

fa2e5fb6-3461-4e90-8138-5797490eaa98

task唯一标识符

resultUrl

String

/rpa/openapi/task/queryServiceResult?taskId=fa2e5fb6-3461-4e90-8138-5797490eaa98

获取结果的url

示例

请求示例:

https://api-rpa.aliyun.com/rpa/openapi/task/createServiceTask?<公共请求参数>
&appId=fb6a99a1-d8bd-46ee-8bed-2ed9cb5a0c0d
&appParams=[{"type":0,"name":"参数一","default":"","value":""}]
&clientId=5E77DA4EB87BCFB62A8B9527626A47F4
&callbackUrl=http://api-rpa.aliyun.com/callback

返回示例:

{
    "requestId":"e6cc72d4-cfa7-42f6-ba38-1aba346181e0",
    "success":true,
    "code":0,
    "msg":"调用成功",
    "msgCode":"result.success",
    "data":{
        "taskId":"fa2e5fb6-3461-4e90-8138-5797490eaa98",
        "resultUrl":"/rpa/openapi/task/queryServiceResult?taskId=fa2e5fb6-3461-4e90-8138-5797490eaa98"
    },
    "pager":null
}

错误代码表

返回代码

描述

语义

0

result.success

调用成功

20201

user.userNotExist

用户不存在

30102

client.clientNotExist

机器人不存在

30800

app.appNotExist

应用不存在

30801

app.appNotInMarket

应用未发布到应用市场

20000

permission.denied

没有权限(本API中表示没有获取对应应用权限)

20110

param.ParamError

参数错误

30206

task.taskCreateServiceTaskFailed

创建服务型任务失败

30202

task.taskScheduleNotExist

计划任务不存在

10004

system.lockedFailed

更新数据失败,请稍后再试

10000

system.systemError

系统发生错误,请稍后重试