钉钉开发文档

审批接入必读

更新时间: 2019-2-14

什么是审批接口

审批接口钉钉将【审批】微应用面向开发者开放的接口,开发者可调用此接口实现【审批】应用上的场景。
审批流程利用审批模板中的表单,加上企业系统的流程 ,在钉钉上发起审批实例。

接口发起的审批限制说明

  • 审批表单只支持单行输入框、多行输入框、图片、明细(只能包含单行输入框、图片)三种控件,如果再包含其它控件调用发起审批接口会报错

image.png

  • 审批实例的审批人和抄送人只能通过发起审批接口传递,不能使用审批表单上设置的默认审批人。
  • 发起审批时不支持附件

使用场景

企业信息系统对接钉钉审批

开发者所在的企业有自己的信息系统,如果想把erp里的审批环节对接到钉钉上,可以通过调用发起审批实例接口,在钉钉【审批】里生成一个审批单,完成审批步骤。

微应用里对接钉钉审批

开发者在钉钉上开发了一个微应用,想复用钉钉【审批】的流程引擎,可以通过接口,把审批流程放到【审批】微应用上。

基础架构

image

名词解释

审批流

打开【审批】微应用,首页展示的各类审批就叫做审批流。

审批表单

审批表单指用户填写审批单子时的页面样式,每个审批流有不同的审批表单。管理员可以在oa管理后台修改每个审批的表单样式。

process_code

每个审批流都会指定一个唯一码,即process_code。具体可以在【钉钉管理后台-审批-编辑表单-顶部url中找到】。

image.png

image.png

审批实例

审批实例指的是用户发起一个审批时,产生的对象。

审批回调

审批回调指当微应用注册了审批回调事件后,钉钉会主动把审批实例的相关变动发送给微应用。

以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!