feat:增加金润对接钉钉审批接口

王富国
1 parent d58f5a8b
Showing 1 changed file with 26 additions and 2 deletions Show diff stats
jinrun/audit/审批接口.md
@@ -67,15 +67,27 @@ appKey(则一提供) + appSecret(则一提供) + timestamp(当前时间戳毫秒
 | code                                | 是  | string | 审批单号(确定数据唯一性,同一单号最多只能有1个审核通过或审核中的审批) |
 | auditType                           | 是  | string | 审批类型(则一提供)                           |
 | username                            | 是  | string | 发起人工号(则一员工工号)                        |
-| auditFormList                       | 是  | list   | 审批表单字段列表                             |
+| auditFormList                       | 是  | array  | 审批表单字段列表                             |
 | &nbsp;&nbsp;&nbsp;&nbsp;type        | 是  | string | 字段类型(1.text 文本格式 2.file 文件格式)        |
 | &nbsp;&nbsp;&nbsp;&nbsp;name        | 是  | string | 字段名称                                 |
 | &nbsp;&nbsp;&nbsp;&nbsp;value       | 是  | string | 字段值(文本格式对应文本内容, 文件格式对应文件url)         |
 | &nbsp;&nbsp;&nbsp;&nbsp;extendValue | 否  | string | 字段附加值                                |
-| conditionParamList                  | 否  | list   | 条件参数字段列表                             |
+| conditionParamList                  | 否  | array  | 条件参数字段列表                             |
 | &nbsp;&nbsp;&nbsp;&nbsp;name        | 是  | string | 属性名                                  |
 | &nbsp;&nbsp;&nbsp;&nbsp;value       | 是  | string | 属性值                                  |
  
+### 返回参数
+
+| 参数名                             | 必传 | 类型      | 说明                             |
+|---------------------------------|----|---------|--------------------------------|
+| success                         | 是  | boolean | 是否成功, true表示请求成功, false表示产生了异常 |
+| businessException               | 是  | boolean | 审批单号                           |
+| errorCode                       | 否  | string  | 错误码                            |
+| message                         | 否  | string  | 异常原因                           |
+| result                          | 否  | object  | 返回结果数据, 请求成功返回,异常不返回           |
+| &nbsp;&nbsp;&nbsp;&nbsp;code    | 是  | string  | 审批单号                           |
+| &nbsp;&nbsp;&nbsp;&nbsp;auditId | 是  | string  | 审批ID                           |
+
 #### 返回示例
  
 ```json
@@ -131,6 +143,18 @@ appKey(则一提供) + appSecret(则一提供) + timestamp(当前时间戳毫秒
 | remark     | 是  | string | 撤销原因                      |
 | username   | 否  | string | 撤销人员工号(发起人则一员工工号, 不传则为系统撤销) |
  
+### 返回参数
+
+| 参数名                             | 必传 | 类型      | 说明                             |
+|---------------------------------|----|---------|--------------------------------|
+| success                         | 是  | boolean | 是否成功, true表示请求成功, false表示产生了异常 |
+| businessException               | 是  | boolean | 审批单号                           |
+| errorCode                       | 否  | string  | 错误码                            |
+| message                         | 否  | string  | 异常原因                           |
+| result                          | 否  | object  | 返回结果数据, 请求成功返回,异常不返回                       |
+| &nbsp;&nbsp;&nbsp;&nbsp;code    | 是  | string  | 审批单号                           |
+| &nbsp;&nbsp;&nbsp;&nbsp;auditId | 是  | string  | 审批ID                           |
+
 #### 返回示例
  
 ```json
...	...	@@ -67,15 +67,27 @@ appKey(则一提供) + appSecret(则一提供) + timestamp(当前时间戳毫秒
67	67	\| code \| 是 \| string \| 审批单号(确定数据唯一性,同一单号最多只能有1个审核通过或审核中的审批) \|
68	68	\| auditType \| 是 \| string \| 审批类型(则一提供) \|
69	69	\| username \| 是 \| string \| 发起人工号(则一员工工号) \|
70		-\| auditFormList \| 是 \| list \| 审批表单字段列表 \|
	70	+\| auditFormList \| 是 \| array \| 审批表单字段列表 \|
71	71	\|     type \| 是 \| string \| 字段类型(1.text 文本格式 2.file 文件格式) \|
72	72	\|     name \| 是 \| string \| 字段名称 \|
73	73	\|     value \| 是 \| string \| 字段值(文本格式对应文本内容, 文件格式对应文件url) \|
74	74	\|     extendValue \| 否 \| string \| 字段附加值 \|
75		-\| conditionParamList \| 否 \| list \| 条件参数字段列表 \|
	75	+\| conditionParamList \| 否 \| array \| 条件参数字段列表 \|
76	76	\|     name \| 是 \| string \| 属性名 \|
77	77	\|     value \| 是 \| string \| 属性值 \|
78	78
	79	+### 返回参数
	80	+
	81	+\| 参数名 \| 必传 \| 类型 \| 说明 \|
	82	+\|---------------------------------\|----\|---------\|--------------------------------\|
	83	+\| success \| 是 \| boolean \| 是否成功, true表示请求成功, false表示产生了异常 \|
	84	+\| businessException \| 是 \| boolean \| 审批单号 \|
	85	+\| errorCode \| 否 \| string \| 错误码 \|
	86	+\| message \| 否 \| string \| 异常原因 \|
	87	+\| result \| 否 \| object \| 返回结果数据, 请求成功返回,异常不返回 \|
	88	+\|     code \| 是 \| string \| 审批单号 \|
	89	+\|     auditId \| 是 \| string \| 审批ID \|
	90	+
79	91	#### 返回示例
80	92
81	93	```json
...	...	@@ -131,6 +143,18 @@ appKey(则一提供) + appSecret(则一提供) + timestamp(当前时间戳毫秒
131	143	\| remark \| 是 \| string \| 撤销原因 \|
132	144	\| username \| 否 \| string \| 撤销人员工号(发起人则一员工工号, 不传则为系统撤销) \|
133	145
	146	+### 返回参数
	147	+
	148	+\| 参数名 \| 必传 \| 类型 \| 说明 \|
	149	+\|---------------------------------\|----\|---------\|--------------------------------\|
	150	+\| success \| 是 \| boolean \| 是否成功, true表示请求成功, false表示产生了异常 \|
	151	+\| businessException \| 是 \| boolean \| 审批单号 \|
	152	+\| errorCode \| 否 \| string \| 错误码 \|
	153	+\| message \| 否 \| string \| 异常原因 \|
	154	+\| result \| 否 \| object \| 返回结果数据, 请求成功返回,异常不返回 \|
	155	+\|     code \| 是 \| string \| 审批单号 \|
	156	+\|     auditId \| 是 \| string \| 审批ID \|
	157	+
134	158	#### 返回示例
135	159
136	160	```json
...	...