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,15 +67,27 @@ appKey(则一提供) + appSecret(则一提供) + timestamp(当前时间戳毫秒
67	\| code \| 是 \| string \| 审批单号(确定数据唯一性,同一单号最多只能有1个审核通过或审核中的审批) \|	67	\| code \| 是 \| string \| 审批单号(确定数据唯一性,同一单号最多只能有1个审核通过或审核中的审批) \|
68	\| auditType \| 是 \| string \| 审批类型(则一提供) \|	68	\| auditType \| 是 \| string \| 审批类型(则一提供) \|
69	\| username \| 是 \| string \| 发起人工号(则一员工工号) \|	69	\| username \| 是 \| string \| 发起人工号(则一员工工号) \|
70	-\| auditFormList \| 是 \| list \| 审批表单字段列表 \|	70	+\| auditFormList \| 是 \| array \| 审批表单字段列表 \|
71	\|     type \| 是 \| string \| 字段类型(1.text 文本格式 2.file 文件格式) \|	71	\|     type \| 是 \| string \| 字段类型(1.text 文本格式 2.file 文件格式) \|
72	\|     name \| 是 \| string \| 字段名称 \|	72	\|     name \| 是 \| string \| 字段名称 \|
73	\|     value \| 是 \| string \| 字段值(文本格式对应文本内容, 文件格式对应文件url) \|	73	\|     value \| 是 \| string \| 字段值(文本格式对应文本内容, 文件格式对应文件url) \|
74	\|     extendValue \| 否 \| string \| 字段附加值 \|	74	\|     extendValue \| 否 \| string \| 字段附加值 \|
75	-\| conditionParamList \| 否 \| list \| 条件参数字段列表 \|	75	+\| conditionParamList \| 否 \| array \| 条件参数字段列表 \|
76	\|     name \| 是 \| string \| 属性名 \|	76	\|     name \| 是 \| string \| 属性名 \|
77	\|     value \| 是 \| string \| 属性值 \|	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	```json	93	```json
	@@ -131,6 +143,18 @@ appKey(则一提供) + appSecret(则一提供) + timestamp(当前时间戳毫秒		@@ -131,6 +143,18 @@ appKey(则一提供) + appSecret(则一提供) + timestamp(当前时间戳毫秒
131	\| remark \| 是 \| string \| 撤销原因 \|	143	\| remark \| 是 \| string \| 撤销原因 \|
132	\| username \| 否 \| string \| 撤销人员工号(发起人则一员工工号, 不传则为系统撤销) \|	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	```json	160	```json