AppList接口
当使用企业自建的We码应用处理“待办”业务时,企业需提供AppList接口。
接口说明
接口名称: (如:待办消息应用查询接口)
请求方式: GET
请求地址: http://www.test.com/api/v1/applist
认证方式: 接口验签
请求参数说明:
参数名称 | 是否传递 | 参数说明 |
---|---|---|
uid | 是 | 用户ID。如zhangsan@welink |
timestamp | 是 | 时间戳。系统当前时间戳13位,如1555000000123。 |
nonce | 是 | 随机数。如52673。 |
signature | 是 | 待办中心的生成的签名。待办服务自签名后与此对比,完成请求合法性校验。如:976e8f40f3be..省略.. |
type | 否 | 调试与验证时会传递该参数,仅用于验证服务是否正常。值为test。 |
响应格式说明
返回结果:
AppList结构定义:
{
"appList": [
{
"appName": "A_application_todo", //A应用名称
"time": "2018-06-15 10:27:29", //最近申请人的申请时间
"appNum": "3", //电子流的数目
"applicant": "zhangsan@welink", //最近申请人userId
"appURL": "h5://A_application_todo/xxx/html/index.html", //A应用微码移动审批处理页面
},
{
"appName": "B_application_todo", //B应用名称
"time": "2018-06-15 10:27:29", //最近申请人的申请时间
"appNum": "1", //电子流的数目
"applicant": "lisi@welink", //最近申请人userId
"appURL": "", //不传URL路径,则表示无对应的微码应用,待办服务将采用默认应用列表打开H5页面
},
{
// 更多数据...
}
],
"status": "1",
"msg": "okay"
}
空数据返回:
{
"appList": [],
"status": "1",
"msg": "okay"
}
返回参数说明:
参数 | 说明 |
---|---|
appList | 返回待办应用的信息列表: appName:应用名称 time:最近申请人的申请时间 appNum:电子流的数目 applicant:最近申请人userId appURL:应用微码移动审批处理页面。不传URL路径,则表示无对应的微码应用,待办服务将采用默认应用列表打开H5页面。 |
status | 返回状态。 |
msg | 返回信息,包括接口请求发生错误时的详细信息。 |