Skip to content

查询审批单详情

查询审批单的详情

请求说明

请求地址配置域名+/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计算方法参考签名说明
Authorizationaccess_token(企业授权获取的token)

请求地址示例

http
[GET] 配置域名+/o/woa/api/v2/workflow/developer/approvals/{approval_id}?operator=

查询参数(Path)

名称类型是否必填说明
approval_codestring审批单code

查询参数(Query)

名称类型是否必填说明
operatorint操作人(wpsUid)

请求体(Body)

请求体示例

响应体

名称类型说明
template_codestring模板混淆id
namestring审批单名称
current_approver[]long当前审批人id
content[]object审批单内容
 ∟ typeint控件类型,枚举如下:(1. 单行文本2. 多行文本3. 文件文本4. 富文本5. 日期6. 单选7. info信息8. 联系人9. 多选10. 数字11. 金额12.图片组件)
 ∟ titlestring控件标题
 ∟ textstring控件内容
 ∟ not_printbool是否参与打印(true:是,false:否)
attachments[]object附件列表
 ∟ fileidstring云文档文件id
 ∟ namestring附件名称
 ∟ typeint附件类型,1-审批内容附件,2-评论附件,3-审批内容图片,4-评论区图片附件
 ∟ store_typeint存储类型,1-云存储,2-云文档
 ∟ store_keystring云存储key
 ∟ storestring存储端的名称,例如ks3
 ∟ thumb_store_keystring存储key
flow_data[]object多条件节点
 ∟ idint模板流程设置的数据流,包含节点配置信息
 ∟ node_typeint流程节点类型 1:审批 2:抄送
 ∟ titlestring流程节点名称
 ∟ select_typeint用户个数类型 1:单选 2:多选
 ∟ user_typeint用户类型 0:指定成员 1:发起人自选,3:上级,4:连续多级上级,5:部门负责人,6:连续多级部门负责人
 ∟ all_user_dismissint所有审批用户离职采取操作 1:转交模板管理员 2:自动审批通过
 ∟ ruleint审批规则:0 逐级审批 1 会签 2 或签
 ∟ add_more_copyersint允许继续添加抄送人(抄送节点user_type=0时有效。 1为允许添加,0不允许)
 ∟ sourceint节点来源(区分是否来自于加签,0正常流程创建,1加签)
 ∟ approvers[]long审批用户成员
 ∟ copyers[]long抄送人id数组

响应体示例

json
{
  "approval_code": "xxxx",
  "approval_order": 202208290000,
  "content": [
    {
      "body": "",
      "date": "",
      "dateplace": "",
      "extra": "{\"not_print\":false}",
      "id": 0,
      "not_print": false,
      "options": null,
      "placeholder": "",
      "required": false,
      "select_value": "",
      "step": "",
      "time": "",
      "timeplace": "",
      "title": "单行文本",
      "type": 1
    }
  ],
  "corpid": "aplzzl6xxx",
  "ctime": 1661744827,
  "current_user_ids": ["exxpP7Q4d1Qxxx"],
  "cuser": {
    "account": "",
    "avatar": "https://xxx",
    "departments": [
      {
        "abs_path": "金山软件/146环境-名字",
        "ctime": 1655083947,
        "id": "exvKbzPxM5Axxx",
        "id_path": "584210946286xxxx",
        "name": "146环境-名字搞长一点",
        "parent_id": "exxpP7mzBlxxxxx"
      }
    ],
    "desc": "",
    "email": "xxx@wps.cn",
    "level": 0,
    "name": "admin",
    "sex": "",
    "user_id": "exxpP7Q4d1Qxxxx"
  },
  "flow_data": [
    {
      "add_more_copyers": 0,
      "all_user_dismiss": 1,
      "approvers": null,
      "copyers": null,
      "id": 2,
      "node_type": 1,
      "rule": 0,
      "select_type": 1,
      "source": 0,
      "title": "审批",
      "user_type": 1
    }
  ],
  "group_chat_id": 0,
  "id": "xyz",
  "name": "admin的开放test2",
  "operator_logs": [
    {
      "action": 1,
      "comment_attachments": null,
      "ctime": 1661744827,
      "id": 879,
      "node_title": "",
      "operate_user": {
        "account": "",
        "avatar": "https://xxx",
        "departments": [
          {
            "abs_path": "金山软件/146环境-名字搞长一点",
            "ctime": 1655083947,
            "id": "exvKbzPxM5Axxxx",
            "id_path": "584210946286243xxx",
            "name": "146环境-名字搞长一点",
            "parent_id": "exxpP7mzBlxxxxx"
          },
          {
            "abs_path": "金山软件/146环境-名字搞长一点0",
            "ctime": 1656313917,
            "id": "axnDamdPBwdxxxx",
            "id_path": "584210946286243xxx",
            "name": "汇报D-400",
            "parent_id": "exvKbzPxM5AQxxx"
          }
        ],
        "desc": "",
        "email": "xxx@wps.cn",
        "level": 0,
        "name": "admin",
        "sex": "",
        "user_id": "exxpP7Q4d1Qxxxx"
      },
      "operator": "exxpP7Q4d1Qxxxx",
      "utime": 1661744827,
      "value": ""
    }
  ],
  "result": 0,
  "state": 1,
  "template_id": "abc",
  "utime": 1661744827,
  "waiting_users": [
    {
      "add_more_copyers": 0,
      "all_user_dismiss": 1,
      "approvers": null,
      "copyers": null,
      "id": 2,
      "node_type": 1,
      "rule": 0,
      "select_type": 1,
      "source": 0,
      "title": "审批",
      "user_type": 1
    }
  ]
}