查询单条待办任务 3.5.4.Beta2+

用于获取具体的某条待办任务明细数据；

接口说明

请求URL：http[s]://{网关地址}/casp-tdc/task/queryTaskById

请求方式： POST

请求内容类型： application/json

响应内容类型： application/json

请求说明

请求体

字段名	参数名	必填	类型	描述
用户工号	userId	M	String(50)	用户工号
任务的技术主键	taskWid	*M	String(128)	由待办中心生成的任务表主键字段。与taskId二选一）
第三方任务ID 3.7.2.Beta3+	taskId	*M	String(64)	任务业务主键，由第三方系统提供, 与请求头中的appId联合查询。与taskWid二选一，当二者都传入时，优先取taskId
多语言 3.5.5.Beta2+	langCountry	O	String	多语言

请求示例

{
    "userId":"ampadmin",
    "taskId":"1234567890123"
}

响应说明

响应体

字段名	参数名	类型	描述
返回码	errcode	String	返回码
返回描述	errmsg	String	返回描述
任务详情	data	Task	任务详情

Task

字段名	参数名	类型	描述
应用ID	appId	String	应用ID
应用名称	appName	String	应用名称
任务的技术主键	taskId	String	由待办中心生成的任务表主键字段
第三方任务ID	realTaskId	String	待办任务业务主键，由第三方提供
任务主题	subject	String	任务主题
任务类型代码	taskTypeCode	integer	1：待阅 2：分发 3：普通 4：内部待阅3.7.3.Beta1+ 5：内部分发3.7.3.Beta1+
任务类型	taskType	String	待阅 ；分发；普通; 内部待阅;3.7.3.Beta1+ 内部分发3.7.3.Beta1+
紧急程度代码	priorityCode	integer	1：特急；2：紧急；3：一般
紧急程度	priority	String	一般；紧急；特急
pc待办任务链接	pcViewUrl	String	pc待办任务链接
h5待办任务链接	h5ViewUrl	String	h5待办任务链接
发起人工号	initiatorId	String	发起人工号
发起人姓名	initiatorName	String	发起人姓名
发起人部门	initiatorDept	String	发起人部门
业务场景名称	sceneName	String	业务场景名称
接收时间	createTime	String	接收时间
流程图URL地址	processInstanceImgUrl	String	流程图URL地址
是否忽略状态	isIgnoreStatus	String	0（正常） 1（忽略）
是否忽略文字	isIgnore	String	正常（0） 忽略（1）
是否过期状态	isExpireStatus	String	0（已过期）1（正常）
是否过期文字	isExpire	String	已过期（0） 正常（1）
过期时间	expireTime	String	过期时间
是否已读	isRead	integer	0：未读 1：已读
是否置顶	isTop	integer	0：未置顶 1：置顶
服务ID	serviceId	String	服务ID
服务名称	serviceName	String	服务名称
消息ID 3.7.4.SP9+	msgId	String	任务关联的消息ID（可用于同步消息已读状态）

响应示例

{
    "errcode": "0",
    "errmsg": "success",
    "data": {
                "appName": "newAppPg0",
                "appId": "998543444844220416",
                "realTaskId": "taskExp02",
                "taskId": "1551482168826753026",
                "subject": "taskSub02",
                "taskType": "普通",
                "taskTypeCode": "3",
                "priority": "一般",
                "isIgnore": "正常",
                "initiatorId": "01111111",
                "initiatorName": "aa(01111111)",
                "initiatorDept": null,
                "isIgnoreStatus": "0",
                "isExpire": "正常",
                "isExpireStatus": "1",
                "sceneName": "testRe1",
                "status": "进行中",
                "expireTime": "2022-07-30T14:00:00",
                "createTime": "2022-07-25T16:19:08.813",
                "updateTime": "2022-07-25T16:19:08.854",
                "pcViewUrl": null,
                "h5ViewUrl": null,
                "processInstanceImgUrl": null,
                "sourceType": "1",
                "bizDomain": null,
                "priorityCode": "3",
                "statusCode": "ACTIVE",
                "isRead": "0",
                "isTop": "0",
                "serviceId": null,
                "serviceName": null,
      			"msgId": "1111"
        }
}

错误码

错误码	描述
371002	参数异常（详细描述信息参见接口返回）
376003	任务记录不存在
376999	系统异常，详细描述信息参见接口返回
999	统一错误码，详细描述信息参见接口返回

Demo

java

// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
// 创建请求对象
QueryTaskByIdRequest request = new QueryTaskByIdRequest();
request.setUserId("xxx");
request.setTaskId("xxx");
request.setLangCountry(LangCountryType.ZH_CN);
QueryTaskByIdResponse response = client.execute(request);
//调用成功，则处理业务逻辑
if (response.isSuccess()) {
    //.....
}