发起审批流程实例

参数名	类型	必填	说明
corpId	String	是	企业ID
operationEmpId	String	是	操作人员工ID（发起审批的员工ID）
entity	UserFormDataEntity	是	表单数据对象
version	Integer	是	表单版本号
resubmitProcInstId	String	否	重新发起时的流程实例ID（用于重新提交审批）

字段名	类型	必填	说明
formKey	String	是	表单唯一标识
serialNumber	Long	否	提交序号
originalData	Map<String, Object>	否	填写结果原始数据（表单字段的值）
submitUa	Map<String, Object>	否	填写用户UA信息
submitOs	String	否	提交操作系统
submitBrowser	String	否	提交浏览器
submitRequestIp	String	否	提交请求IP地址
submitAddress	String	否	提交地址
completeTime	Long	否	完成时间（时间戳）
extValue	String	否	扩展字段
optionalData	ApproveFormOptional[]	否	发起人自选审批人/抄送人

字段名	类型	说明
id	String	节点ID
empIds	List<String>	员工ID列表（自选的审批人或抄送人）
settype	Integer	设置类型（1：会签，2：或签）

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json

示例

{
  "corpId": "",
  "operationEmpId": "",
  "entity": {
    "id": 0,
    "createTime": "",
    "updateTime": "",
    "searchValue": "",
    "createBy": "",
    "updateBy": "",
    "params": {
      "": {}
    },
    "corpId": "",
    "formKey": "",
    "serialNumber": 0,
    "originalData": {
      "basicInfo": {
        "name": "测试员工"
      },
      "workStatusInfo": {
        "employeeType": [
          {
            "label": "劳务外包",
            "value": "epiboly",
            "key": "epiboly"
          }
        ]
      },
      "workInfo": {
        "mainDepartment": [
          {
            "label": "测试部门",
            "value": "org_xxx",
            "orgLabel": "测试部门",
            "nodeType": 2,
            "orgId": "org_xxx"
          }
        ]
      },
      "actual_emp": [
        {
          "label": "测试员工",
          "value": "emp_target_xxx",
          "nodeType": 1,
          "empId": "emp_target_xxx"
        }
      ],
      "empId": "emp_target_xxx"
    },
    "formType": "",
    "submitUa": {
      "": {}
    },
    "submitOs": "",
    "submitBrowser": "",
    "submitRequestIp": "",
    "submitAddress": "",
    "completeTime": 0,
    "extValue": "",
    "optionalData": [
      {
        "id": "",
        "empIds": [
          ""
        ],
        "settype": 0
      }
    ]
  },
  "version": 0,
  "resubmitProcInstId": ""
}

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location 'https://app91651.eapps.dingtalkcloud.com/tduck-api/open/api/v1/approval/data/create' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "corpId": "",
  "operationEmpId": "",
  "entity": {
    "id": 0,
    "createTime": "",
    "updateTime": "",
    "searchValue": "",
    "createBy": "",
    "updateBy": "",
    "params": {
      "": {}
    },
    "corpId": "",
    "formKey": "",
    "serialNumber": 0,
    "originalData": {
      "basicInfo": {
        "name": "测试员工"
      },
      "workStatusInfo": {
        "employeeType": [
          {
            "label": "劳务外包",
            "value": "epiboly",
            "key": "epiboly"
          }
        ]
      },
      "workInfo": {
        "mainDepartment": [
          {
            "label": "测试部门",
            "value": "org_xxx",
            "orgLabel": "测试部门",
            "nodeType": 2,
            "orgId": "org_xxx"
          }
        ]
      },
      "actual_emp": [
        {
          "label": "测试员工",
          "value": "emp_target_xxx",
          "nodeType": 1,
          "empId": "emp_target_xxx"
        }
      ],
      "empId": "emp_target_xxx"
    },
    "formType": "",
    "submitUa": {
      "": {}
    },
    "submitOs": "",
    "submitBrowser": "",
    "submitRequestIp": "",
    "submitAddress": "",
    "completeTime": 0,
    "extValue": "",
    "optionalData": [
      {
        "id": "",
        "empIds": [
          ""
        ],
        "settype": 0
      }
    ]
  },
  "version": 0,
  "resubmitProcInstId": ""
}'

返回响应

🟢200createFormApproval-Example

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "",
    "data": {
        "key": {}
    }
}

请求参数

请求体 (OpenCreateUserFormRequest)

entity 对象详细字段 (UserFormDataEntity)

ApproveFormOptional 对象

请求参数

请求示例代码

返回响应