在【审批后台】找到我们的审批定义,点击编辑按钮,即可在地址栏找到这个审批对应的 Approval Code。此时在地址栏的最后输入参数 &devMode=on 即可进入开发者模式,在开发者模式下可以指定表单控件和流程节点的自定 义 ID,方便之后的开发工作,具体的编辑页面如下图。如果设置了自定义 ID,则可以通过自定义 ID 来指定一个唯一的控件或者一个唯一的节点。在一个审批定义中自定义 ID 不可重复。
1.
获得开放平台Token
在开放平台找到刚才发布通过了的应用,我们可以找到这个应用对应的 App ID 和 App Secret。根据开放平台【获取 token】这个文档取得你的 APP 对应的 token,token 有效期为 2 小时,过期后需要重新获取。接下来我们使用的全部都是 tenant_access_token。在Postman 中先设置请求头,在审批 API 中请求头都是一样的。箭头位置填写刚才获得的 tenant_access_token。
1.
查看审批定义
通过【查看审批定义】接口,我们可以通过 API 查询到我们刚才创建的审批定义。使用刚才的 Approval Code 来试一下:在 Postman 的地址栏中填入请求地址,请求方法为 POST,并在 Body 中选取 raw,以 json 格式填写所需参数,approval_code 处填写刚才第二步获得的 Approval Code 即可。\5. 上传文件如果我们想要通过 API 使用刚才创建的定义来创建一个新的审批实例,则需要先进行文件上传,因为我们在审批定义中含有一个图片控件。下面我们来通过【上传文件】API 先进行文件的上传:在 Postman 的地址栏中填入请求地址,请求方法为 POST,并在 Body 中选取 form-data,填写相关字段,并在 content 这一栏中选择 File,在 value 处选择一个本地文 件。上传成功后我们会收到如下回应,请记住其中的 code,在之后的实例创建过程中会用到这个 code。
1.
创建审批实例(获取审批实例的instance_code)
接下来我们正式开始创建实例,请先阅读【创建审批实例】文档来熟悉一下请求 body。这里展示的是在刚才创建的审批定义下,创建应审批实例的请求 body:在 Postman 的地址栏中填入请求地址,请求方法为 POST,并在 Body 中选取 raw,以 json 格式填写所需参数,approval_code 处填写刚才第二步获得的 Approval Code,user_id 和 department_id 填写申请发起人的信息,node_approver_user_id_list 和form 字段按照文档描述填写即可,这个例子中涉及到【发起人自选】概念,具体描述可以查看【审批应用开发指南】。这里也可以用到我们在第 2 步设置的自定义表单 ID 和节点 ID 来进行创建,比如说我们指定了数字控件的自定义 ID 为『number』,发起人自选节点的ID为『node1』,则可以将下面的请求中『form』字段里的数字控件默认 ID 替换为『number』,将『node_approver_user_id_list』字段里的『855XXX』这个发起人自选节点的默认 ID 替换为『node1』。需要注意的是,审批定义在修改并发布后不能保证原有控件的默认 ID 不变,但是自定义 ID 会保证不随着定义的修改而变动,只要这个控件没有被删除或者删除后重新添加并保证自定义 ID 一致,那可以一直使用自定义 ID 访问到这个控件。所以我们更推荐使用自定义 ID 来进行开发。创建成功以后,我们会收到一个如下所示返回值:其中,instance_code 则是我们创建的这个实例对应的 code。现在我们可以在【审批前台】的『我发起的』列表页看到刚才我们通过 API 发起的审批实例(如果你的 user_id 和 department_id 填的是自己的话)。
1.
获取审批实例详情(获取审批任务的id)
现在我们可以通过实例的 ID 来查看审批实例的详情了,我们来通过 API 查看一下刚才创建的实例:在 Postman 的地址栏中填入请求地址,请求方法为 POST,并在 Body 中选取 raw,以 json 格式填写所需参数, instance_code 处填写刚才第 6 步中返回的 code 即可。其中返回的数据里task_list里的id即为审批任务的id,后续的审批任务相关操作可以使用这个id