TaskList接口
当企业有待办应用,但企业无对应的We码应用处理“待办”业务时,Workplace支持企业通过H5页面来处理“待办”,企业需提供TaskList接口。
接口说明
接口名称: (如:待办消息详情查询接口)
请求方式: GET
认证方式: 接口验签
请求地址: http://www.test.com/api/v1/tasklist
请求参数说明:
参数名称 | 是否传递 | 参数说明 |
---|---|---|
uid | 是 | 用户ID。如zhangsan@welink |
timestamp | 是 | 时间戳。系统当前时间戳13位,如1555000000123 |
nonce | 是 | 随机数。 如52673 |
appname | 是 | 调用taskList的时候,会传递该参数,待办服务根据该参数查询当前应用的任务清单。如todo1 |
signature | 是 | 待办中心的生成的签名。待办服务自签名后与此对比,完成请求合法性校验。如:976e8f40f3be..省略.. |
type | 否 | 调试与验证时会传递该参数,仅用于验证服务是否正常。 值为test。 |
响应格式说明
返回结果:
TaskList 数据结构定义
{
"taskList": [
{
"taskDesc": "B todo task description", // 任务描述信息
"time": "2018-06-15 10:27:29", //最近申请人的申请时间
"applicant": "lisi@welink", //最近申请人userId
"taskURL": "https://task.test.com/app1/xxx", //H5待办处理页面1
"appName": "B_application_todo"
},
{
"taskDesc": "B todo task description", // 任务描述信息
"time": "2018-06-15 10:27:29", //最近申请人的申请时间
"applicant": "wangwu@welink", //最近申请人userId
"taskURL": "https://task.test.com/app1/xxx", //H5待办处理页面2
"appName": "B_application_todo"
}
],
"status": "1",
"msg": "okay"
}
空数据返回:
{
"taskList": [],
"status": "1",
"msg": "okay"
}
返回参数说明:
参数 | 说明 |
---|---|
taskList | 返回任务的信息列表: taskDesc:任务描述信息 time:最近申请人的申请时间 applicant:最近申请人userId taskURL:H5待办处理页面 appName:应用名称 |
status | 返回状态。 |
msg | 返回信息,包括接口请求发生错误时的详细信息。 |