查询审批单列表
查询审批单列表
请求说明
| 请求地址 | 配置域名+/o/woa/api/v2/workflow/developer/approvals |
|---|---|
| 请求方法 | GET |
| 签名方式 | wps-4 |
| 支持应用类型 | 企业自建应用、第三方企业应用 |
| 权限要求 | 查询审批单信息(kso.workflow.approval.read) |
请求头
| Header名称 | 是否必填 | 说明 |
|---|---|---|
| Content-Type | 是 | 目前固定为："application/json" |
| Wps-Docs-Date | 是 | 取当前时间, 示例: Wed, 23 Jan 2013 06:43:08 GMT |
| Wps-Docs-Authorization | 是 | 计算方法参考签名说明 |
| Authorization | 是 | access_token(企业授权获取的token) |
请求地址示例
http
[GET] 配置域名+/o/woa/api/v2/workflow/developer/approvals?offset=0&limit=20&operator=1221查询参数（Query）
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| operator | int | 是 | 操作人（wpsUid） |
| offset | int | 是 | 分页起始节点，默认 0 |
| limit | int | 否 | 每页条数 默认 20 |
| read_status | int | 是 | 0：所有 1：未读 2：已读 |
| state | int | 否 | 状态，枚举如下（1. 审核中 2. 已通过 3. 已拒绝 4. 已退回 5. 已撤回 6. 无需审批） |
| order | int | 否 | 0 最久等待优先 1 最先发起优先 默认按最久等待优先排序 |
| template_id | string | 否 | 模板为0表示不指定模板 |
| approval_ids | []int64 | 否 | 审批单id列表 |
| keyword | string | 否 | 搜索关键词 |
| tab | int | 是 | 默认传1 |
请求体（Body）
无
请求体示例
无
响应体
| 名称 | 类型 | 说明 |
|---|---|---|
| id | int | 审批单id |
| name | string | 审批单名称 |
| approval_code | string | 审批单混淆id |
| read_status | int | 是 |
| state | int | 否 |
| template_id | int | 模板id |
| corpid | int | 企业id |
| ctime | long | 创建时间 |
| utime | long | 更新时间 |
| view_time | long | 查看时间 |
| approval_user_ids | []long | 审批用户id数组 |
| current_user_ids | []long | 当前用户id数组 |
| cuser | object | 发起人用户信息 |
| ∟ account | string | 用户账号 |
| ∟ avatar | string | 用户头像 |
| string | 用户邮箱 | |
| ∟ level | int | 用户级别（wps+返回） |
| ∟ name | string | 用户姓名 |
| ∟ user_id | long | 用户id |
| content | []object | 审批单内容 |
| ∟ type | int | 控件类型，枚举如下：（1. 单行文本2. 多行文本3. 文件文本4. 富文本5. 日期6. 单选7. info信息8. 联系人9. 多选10. 数字11. 金额12.图片组件） |
| ∟ title | string | 控件标题 |
| ∟ text | string | 控件内容 |
| ∟ not_print | bool | 是否参与打印（true：是，false：否） |
| attachments | []object | 附件列表 |
| ∟ name | string | 附件名称 |
| ∟ type | int | 附件类型，1-审批内容附件，2-评论附件，3-审批内容图片，4-评论区图片附件 |
| ∟ store_type | int | 存储类型，1-云存储，2-云文档 |
| ∟ store_key | string | 云存储key |
| ∟ file_id | string | 云文档文件id |
| ∟ store | string | 存储端的名称，例如ks3 |
| ∟ thumb_store_key | string | 存储key |
响应体示例
json
{
"approval_code": "xyz",
"name":"xx提交的考勤异常说明",
"state":1,
"ctime":1629366711,
"utime":1629366711,
"view_time":1629366711,
"read_status":1,
"approval_user_ids": ["exxpP7Q4d1xxxx"],
"current_user_ids": ["exxpP7Q4d1Qxxxx"],
"cuser":{
"user_id":"exxpP7Q4d1Qxxxx",
"desc":"",
"name":"zpf",
"sex":"",
"avatar":"https://xxx",
"email":"xxx@wps.cn",
"account":"xxx@wps.cn"
},
"content":[
{
"type":1,
"title":"详细信息",
"text":"xxx手段",
"attachments":[
{
"id":12,
"approval_id":12,
"corpid":"aplzzlxxx",
"name":"ssdasadsadds",
"type":1,
"value_id":12,
"store_type":2,
"size":1212245,
"store":"ks3",
"store_key":"",
"fileid":"5454yrrtyry0000",
"link":"www.baidu.com",
"ctime":1629366711,
"utime":1629366711
}
]
}
]
}
]