钉钉开放平台API对接第三讲

最新推荐文章于 2026-05-15 10:52:31 发布

原创

最新推荐文章于 2026-05-15 10:52:31 发布 · 2.4w 阅读

本文详细介绍了如何使用钉钉开放平台的API进行服务端发起审批实例的操作。首先，需要在钉钉后台创建审批模板，然后通过自定义模板拖动控件配置需求。接着，重点讲解了API调用的指定审批人模式，并提供了相关实现代码。

钉钉开放平台-服务端API-发起审批实例
官方API: https://ding-doc.dingtalk.com/doc#/serverapi2/cmct1a

需要做的事项：
1、进入钉钉后台管理-工作台-审批-创建新审批-自定义模板
2、按界面拖控件定义好您需要的模板

API调用方式：指定审批人模式。
实现代码：

/// <summary>
/// 智能工作流-发起审批实例
/// </summary>
/// <returns></returns>
public async Task<OapiCreateProcessInstanceResult> CreateProcessInstanceAsync(CreateProcessInstanceRequestInfo requestInfo)
{
    await StaffsCheckedAsync();

    requestInfo.TaskActionType = requestInfo.TaskActionType ?? "AND";
    requestInfo.CCPosition = requestInfo.CCPosition ?? "START";

    var originatorStaffInfo = _staffs.FirstOrDefault(m => m.StaffNumber.Equals(requestInfo.OriginatorStaffNumber));
    if (originatorStaffInfo == null) return null;

    var approverUserids = new List<string>();
    foreach(var staffNumber in requestInfo.Approvers)
    {
        var staffInfo = _staffs.FirstOrDefault(m => m.StaffNumber.Equals(staffNumber, StringComparison.OrdinalIgnoreCase));
        if (staffInfo != null) approverUserids.Add(staffInfo.Id);
    }

    var copyUserids = _staffs.Where(m => requestInfo.CopyPersons.Contains(m.StaffNumber)).Select(m => m.Id);
    var cclist = (copyUserids == null || !copyUserids.Any()) ? null : string.Join(",", copyUserids);
    var ccposition = !string.IsNullOrEmpty(cclist) ? requestInfo.CCPosition : null;

    List<OapiProcessInstanceApproverVo> approvers = null;

    if (requestInfo.TaskActionType.Equals("OR", StringComparison.OrdinalIgnoreCase) && (approverUserids != null && a