# 创建审批实例

根据 Approval Code 创建审批实例，可以先调用「查询审批定义」接口进行审批定义的熟悉后调用此接口创建审批实例。

注意事项：

  • 使用该接口发起审批的用户必须拥有该审批在管理后台配置「可以发起这个审批」，否则会发起失败

# 请求

基本
HTTP URL https://hi-gw.weizhipin.com/open-apis/approval/v2/instances
HTTP Method POST
支持的应用类型 自建应用
商店应用
权限要求 查询、编辑、创建审批实例

# 请求头

名称 类型 必填 描述
Authorization string 是 tenant_access_token
值格式："Bearer access_token"
示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560"
Content-Type string 是 固定值："application/json; charset=utf-8"

# 查询参数

名称 类型 必填 描述
user_id_type String 是 用户 ID 类型
示例值："open_id"
可选值有：
open_id：用户的 open id
union_id：用户的 union id
user_id：用户的 user id
默认值：open_id
当值为 user_id，字段权限要求：
获取用户 user ID

# 请求体

名称 类型 必填 描述
approval_code string 是 审批定义 code
user_id string 是 审批发起人user_id
form_value string 是 审批表单值，根据审批定义API查询出表单信息，组装value
注意: *** 为json转换为字符串 ***

# 请求体示例

{
  "approval_code": "7f05d7fa9246dfdf1nJ93d-4F1BQwY63UvuXRuCr",
  "user_id": "11111111435",
  "form_value": "[  {\"code\": \"field_1001_1676257040745\",\"value\": \"单行输入的的的 的的\"  },  {\"code\": \"field_1002_1676257042172\",\"value\": \"多行的单行输入的的的 单行输入的的的 的的单行输入的的的 的的单行输入的的的 的的单行输入的的的 的的单行输入的的的 的的单行输入的的的 的的单行输入的的的 的的单行输入的的的 的的单行输入的的的 的的单行输入的的的 的的\"  },  {\"code\": \"field_2001_1676257045936\",\"value\": \"9983723\"  },  {\"code\": \"field_2002_1676257047308\",\"value\": \"9983723.2334\"  },  {\"code\": \"field_2003_1676257049473\",\"value\": \"1119983723111\"  },  {\"code\": \"field_3001_1676257077134\",\"value\": \"0\"  },  {\"code\": \"field_3002_1676257080017\",\"value\": [  \"1\",  \"2\",  \"3\"]  },  {\"code\": \"field_4001_1676257088445\",\"value\": \"2023-09-09\"  },  {\"code\": \"field_4002_1676257090922\",\"value\": \"2023-09-09,2023-09-10,100年\"  },  {\"code\": \"field_5001_1676257094656\",\"value\": [  \"https://lmg.jj20.com/up/allimg/1114/040221103339/210402103339-8-1200.jpg\",  \"https://lmg.jj20.com/up/allimg/1114/040221103339/210402103339-8-1200.jpg\",  \"https://lmg.jj20.com/up/allimg/1114/040221103339/210402103339-8-1200.jpg\",  \"https://lmg.jj20.com/up/allimg/1114/040221103339/210402103339-8-1200.jpg\"]  },  {\"code\": \"field_5003_1676257134379\",\"value\": [  {    \"name\": \"hello\",    \"value\": \"https://lmg.jj20.com/up/allimg/1114/040221103339/210402103339-8-1200.jpg\"  },  {    \"name\": \"hello\",    \"value\": \"https://lmg.jj20.com/up/allimg/1114/040221103339/210402103339-8-1200.jpg\"  },  {    \"name\": \"hello\",    \"value\": \"https://lmg.jj20.com/up/allimg/1114/040221103339/210402103339-8-1200.jpg\"  }]  },  {\"code\": \"field_5006_1676257144021\",\"value\": \"瞎写一个地址看看看怎么样\"  },  {\"code\": \"field_5002_1676257149398\",\"value\": [  [    {      \"value\": \"明细中的单行\"    },    {      \"value\": \"明细中的多行\"    },    {      \"value\": \"1\"    },    {      \"value\": \"1\"    },    {    },    {      \"value\": \"0\"    },    {      \"value\": [        \"0\",        \"1\"      ]    },    {      \"value\": \"2011-01-01\"    },    {      \"value\": \"2011-01-01,2011-01-02,1天天的\"    },    {    },    {    },    {    },    {    },    {      \"value\": \"地址吗\"    },    {    }  ],  [    {      \"value\": \"明细中的\"    },    {      \"typeName\": \"明细中的多行\"    },    {      \"value\": \"1\"    },    {      \"value\": \"1\"    },    {    },    {      \"value\": \"0\"    },    {      \"value\": [        \"0\",        \"1\",        \"2\"      ]    },    {      \"value\": \"2011-01-01\"    },    {      \"value\": \"2011-01-01,2011-01-02,1天天的\"    },    {    },    {    },    {    },    {    },    {      \"value\": \"地址吗\"    },    {    }  ]]  }]"
}
1
2
3
4
5

# 响应

# 响应体

名称 类型 必填 描述
code int 错误码，非 0 表示失败
msg string 错误描述
data - -
 ∟instance_id string 是 审批实例ID

# 响应体示例

{
  "code": 0,
  "traceId": "_Ao59UOIBLPCeAAu",
  "success": true,
  "data": "10001023481233347592",
  "msg": "操作成功"
}
1
2
3
4
5
6
7

# 控件格式

注意:

  • 注意当控件的code与value与code不一致时，审批创建会失败

# 单行文本

{
  "code": "field_1001_1676257040745",
  "value": "单行输入的的的 的的"
}
1
2
3
4

# 多行文本

{
  "code": "field_1002_1676257042172",
  "value": "多行的单行输入的的的 单行输入的的的 的的单行输入的的的 的的单行输入的的的 的的单行输入的的的 的的单行输入的的的 的的单行输入的的的 的的单行输入的的的 的的单行输入的的的 的的单行输入的的的 的的单行输入的的的 的的"
}
1
2
3
4

# 数字输入框

{
  "code": "field_2001_1676257045936",
  "value": "9983723"
}
1
2
3
4

# 金额

{
  "code": "field_2002_1676257047308",
  "value": "9983723.2334"
}
1
2
3
4

# 计算公式

{
  "code": "field_2003_1676257049473",
  "value": "1119983723111"
}
1
2
3
4

# 单选

注意:

  • value 为 定义中 option 中的 value 字段
{
  "code": "field_3001_1676257077134",
  "value": "0"
}
1
2
3
4

# 多选

注意:

  • value 为 定义中 option 中的 value 字段
{
  "code": "field_3002_1676257080017",
  "value": [
    "1",
    "2",
    "3"
  ]
}
1
2
3
4
5
6
7
8

# 日期

{
  "code": "field_4001_1676257088445",
  "value": "2023-09-09"
}
1
2
3
4

# 日期区间

注意:

  • value值为：开始日期,结束日期,间隔天数
{
  "code": "field_4002_1676257090922",
  "value": "2023-09-09,2023-09-10,100年"
}
1
2
3
4

# 图片

{
  "code": "field_5001_1676257094656",
  "value": [
    "https://lmg.jj20.com/up/allimg/1114/040221103339/210402103339-8-1200.jpg",
    "https://lmg.jj20.com/up/allimg/1114/040221103339/210402103339-8-1200.jpg",
    "https://lmg.jj20.com/up/allimg/1114/040221103339/210402103339-8-1200.jpg",
    "https://lmg.jj20.com/up/allimg/1114/040221103339/210402103339-8-1200.jpg"
  ]
}
1
2
3
4
5
6
7
8
9

# 附件

{
  "code": "field_5003_1676257134379",
  "value": [
    {
      "name": "hello",
      "value": "https://lmg.jj20.com/up/allimg/1114/040221103339/210402103339-8-1200.jpg"
    },
    {
      "name": "hello",
      "value": "https://lmg.jj20.com/up/allimg/1114/040221103339/210402103339-8-1200.jpg"
    },
    {
      "name": "hello",
      "value": "https://lmg.jj20.com/up/allimg/1114/040221103339/210402103339-8-1200.jpg"
    }
  ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

# 地址

{
  "code": "field_5006_1676257144021",
  "value": "瞎写一个地址看看看怎么样"
}
1
2
3
4

# 明细

注意:

  • 若有多个明细，请传入多个数组，每个数组中根据控件顺序传入value即可；
  • 与其他单独的控件不同的是，若一个控件没有值传入，也需要{}进行占位
{
  "code": "field_5002_1676257149398",
  "value": [
    [
      {
        "value": "明细中的单行"
      },
      {
        "value": "明细中的多行"
      },
      {
        "value": "1"
      },
      {
        "value": "1"
      },
      {},
      {
        "value": "0"
      },
      {
        "value": [
          "0",
          "1"
        ]
      },
      {
        "value": "2011-01-01"
      },
      {
        "value": "2011-01-01,2011-01-02,1天天的"
      },
      {},
      {},
      {},
      {},
      {
        "value": "地址吗"
      },
      {}
    ],
    [
      {
        "value": "明细中的"
      },
      {
        "typeName": "明细中的多行"
      },
      {
        "value": "1"
      },
      {
        "value": "1"
      },
      {},
      {
        "value": "0"
      },
      {
        "value": [
          "0",
          "1",
          "2"
        ]
      },
      {
        "value": "2011-01-01"
      },
      {
        "value": "2011-01-01,2011-01-02,1天天的"
      },
      {},
      {},
      {},
      {},
      {
        "value": "地址吗"
      },
      {}
    ]
  ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
最后更新于 : 8/21/2023, 4:57:10 PM

← 查询审批定义 →