系统参数-第三方接口

# 第三方接口

第三方接口主要用来针对平台的流程信息，可以方便和第三方进行对接

## 工作流集成第三方接口

当有待办产生或者待办变成已办时，会触发改接口的调用。

1、在系统后台\-\>系统管理\-\>系统参数\-\>第三方接口 中进行设置，如下图：

![](/media/202507//1751942064.334405.png)

2、第三方接口示例

```
/// <summary>
/// 工作流集成第三方接口
/// </summary>
/// <returns></returns>
[HttpPost()]
public bool DoTheThirdFlowMessage([FromBody] TheThirdFlowRequest request)
{
    if (request.Type == "add")
    {
        //新增待办
    }
    else if (request.Type == "remove")
    {
        //待办变已办
    }
    return true;
}
```

3、接口入参 TheThirdFlowRequest 类的定义

```
public class TheThirdFlowRequest
{
    /// <summary>
    /// 用户消息
    /// 
    /// </summary>
    public UserInfo UserInfo { get; set; }
    /// <summary>
    /// 流程workitemId
    /// </summary>
    public string WorkItemId { get; set; }
    /// <summary>
    /// 模块code
    /// </summary>
    public string WorkflowCode { get; set; }
    /// <summary>
    /// 表名
    /// </summary>
    public string TableName { get; set; }
    /// <summary>
    /// 数据id
    /// </summary>
    public string DataId { get; set; }
    /// <summary>
    /// 待办类型
    /// </summary>
    public string Type { get; set; }
}

public class UserInfo
{
    public string UserId { get; set; }
    public string UserCode { get; set; }
    public string UserName { get; set; }

public string Mobile { get; set; }
}
```

* UserInfo：接收待办的人员信息，如存在多个待办人，会遍历进行该接口的调用

* TableName：业务表的表名，根据 DataId 和表名可以进行业务数据的查询

* DataId：当前操作的业务数据的主键 ID

* Type：待办类型，有 add 和 remove 两个值

1. add ：新增待办

1. remove：待办变已办

* WorkflowCode：流程 Code 和功能模块 Code 是一致的，访问功能列表，URL 最后的参数为功能模块 Code ，如下图：![](/media/202507//1751942064.341678.png)

当 A 提交流程到 B 审批，这时 DoTheThirdFlowMessage 接口会被调用两次：

* 一次是 Type 为 add，UserInfo 为 B 的信息

* 一次是 Type 为 remove ，表示 A 由待办变已办，UserInfo 为 A 的信息