Claim Task¶
认领任务。
请求格式¶
POST https://{apigw-address}/enos-bpm-service/v2.0/work/tasks/claim
请求参数(Header)¶
名称 |
位置 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|---|
Authorization |
Header |
必需 |
String |
Access Token,以 Bearer Token 表示,需要通过调用 Log In 或 Refresh Access Token 接口后获取。 |
请求参数(URI)¶
名称 |
位置(Path/Query) |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|---|
taskId |
Query |
必需 |
String |
任务 ID。 |
响应参数¶
名称 |
数据类型 |
描述 |
---|---|---|
data |
data 结构体 |
被认领任务的信息。 |
data 结构体¶
名称 |
数据类型 |
描述 |
---|---|---|
taskStatus |
String |
任务状态(inProgress,completed,unclaimed)。 |
错误码¶
代码 |
描述 |
---|---|
33403 |
当前用户没有权限认领该任务。 |
33404 |
任务 ID 不存在。 |
示例¶
请求示例¶
url: https://{apigw-address}/enos-bpm-service/v2.0/work/tasks/claim?taskId={your_task_id}
method: POST
headers: {"Authorization":"Bearer {your_access_token}"}
返回示例¶
{
"code": 0,
"msg": "",
"data": {
"taskStatus": "inProgress"
}
}
Java SDK 调用示例¶
public class BpmSdkTest{
@Test
public void claimTaskTest() {
String bearerToken = "your_bearer_token";
String taskId = "task_id";
TaskClaimRequest request = new TaskClaimRequest(taskId, bearerToken);
TaskClaimResponse response = Poseidon.config(PConfig.init().appKey("your_access_key")
.appSecret("your_secret_key").debug()).url("https://{apigw-address}")
.getResponse(request, TaskClaimResponse.class);
assertNotNull("response cannot be null", response);
}
}